Tags

Endpunkte zum Auflisten, Erstellen und Löschen von Tags. Tags sind flexible, kategorieübergreifende Labels, die jedes Paperarchive-Dokument zusätzlich strukturieren.

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

Scope:tags:read

Alle Tags über zugängliche Spaces hinweg auflisten. Tags bieten flexible Beschriftung für Dokumente über Kategorien hinaus.

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.

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"