Tags

Endpoints for listing, creating, and deleting tags.

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

Scope:tags:read

List all tags across accessible spaces. Tags provide flexible labeling for documents beyond categories.

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

Create a new tag in a space.

Request body

Name	Type	Required	Description
`name`	string	required	Tag name.
`space_id`	uuid	required	Space to create the tag in.

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

Delete a tag. Only works for tags in spaces accessible by your API key.

Path parameters

Name	Type	Required	Description
`id`	uuid	required	The tag ID to delete.

Code examples

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