Tags

curl -X GET "/v1/tags"

Run the request to inspect the response.

curl -X POST "/v1/tags" -H "Content-Type: application/json" -d '{
  "url": "https://example.com"
}'

Run the request to inspect the response.

curl -X PATCH "/v1/tags/{id}" -H "Content-Type: application/json" -d '{
  "url": "https://example.com"
}'

Run the request to inspect the response.

curl -X DELETE "/v1/tags/{id}"

Run the request to inspect the response.

curl -X GET "/v1/tags/count"

Run the request to inspect the response.

A Tag is a workspace-scoped label that can be attached to any Page via the tagIds field on POST /v1/moments. Tags are composable with collections and useful for filtering.

Endpoints

Method	Path	Scope
GET	/v1/tags	tags.read
POST	/v1/tags	tags.write
PATCH	/v1/tags/{id}	tags.write
DELETE	/v1/tags/{id}	tags.write
GET	/v1/tags/count	tags.read

Filtering by tag

GET /v1/moments?tagIds=tag_marketing,tag_changelog filters the list to pages carrying either of those tags. Combine with collectionId to narrow further.

Spec

The full request and response shapes are in the OpenAPI spec at /api/v1/openapi — see the Tags tag.