Tags

Endpunkte zum Auflisten, Erstellen und Löschen von Tags. Tags sind flexible, kategorieübergreifende Labels für jedes Paperarchive-Dokument.

GET https://api.paperarchive.io/v1/tags

Scope:tags:read

Alle Tags auflisten, die in den für deinen API-Schlüssel zugänglichen Spaces verfügbar sind: Tags, die einem Space zugeordnet sind, und Tags auf Dokumenten in diesem Space. Zu jedem Tag stehen die Spaces, in denen er verfügbar ist.

Query parameters

Name	Type	Required	Description
`space_id`	uuid	optional	Nur Tags, die in diesem Space verfügbar sind.

Code examples

curl -X GET "https://api.paperarchive.io/v1/tags" \
  -H "Authorization: Bearer pa_live_abc123def456"

POST https://api.paperarchive.io/v1/tags

Scope:tags:write

Einen neuen Tag in einem Space erstellen. Tag-Namen sind pro Nutzer eindeutig, unabhängig von Groß- und Kleinschreibung: Hast du schon einen Tag mit diesem Namen, wird er mit Status 200 statt 201 zurückgegeben und ist danach auch im angegebenen Space verfügbar.

Request body

Name	Type	Required	Description
`name`	string	required	Tag-Name.
`space_id`	uuid	required	Space, in dem der Tag erstellt werden soll.

Code examples

curl -X POST "https://api.paperarchive.io/v1/tags" \
  -H "Authorization: Bearer pa_live_abc123def456" \
  -H "Content-Type: application/json" \
  -d '{"name": "important", "space_id": "space-uuid-1"}'

DELETE https://api.paperarchive.io/v1/tags/:id

Scope:tags:write

Einen Tag löschen. Funktioniert nur für Tags in Spaces, die für deinen API-Schlüssel zugänglich sind.

Path parameters

Name	Type	Required	Description
`id`	uuid	required	Die zu löschende Tag-ID.

Code examples

curl -X DELETE "https://api.paperarchive.io/v1/tags/tag-uuid-1" \
  -H "Authorization: Bearer pa_live_abc123def456"