Tags API

2 operations. Authentication, errors and pagination work as described in the REST API overview.

GET/api/v1/tagsPublic

listTags parameters
Name	Type	Description
`q` query	`string`	Filter tags by name/slug (prefix or fuzzy)
`kind` query	`"topic" \| "model" \| "stack" \| "usecase"`
`cursor` query	`string`
`limit` query	`integer (1–200)`

Responses: 200 OK304, 400, 404, 429

Response fields

listTags response fields
Name	Type	Description
`items`required	`object[]`
`nextCursor`required	`string \| null`

Example

curl 'https://incantory.ai/api/v1/tags'

A tag and its public prompts

GET/api/v1/tags/{tag}Token optional

An alias tag answers 301 to its canonical tag.

getTag parameters
Name	Type	Description
`tag` pathrequired	`string`	Tag slug
`sort` query	`"trending" \| "new" \| "top"`	trending (default), new or top
`kind` query	`"text" \| "chat" \| "image" \| "video" \| "skill" \| "rules" \| "agent"`	Prompt kind
`cursor` query	`string`
`limit` query	`integer (1–60)`

Responses: 200 OK301, 304, 400, 404, 429

Response fields

getTag response fields
Name	Type	Description
`tag`required	`object`
`prompts`required	`object`

Example

curl 'https://incantory.ai/api/v1/tags/{tag}' \
  -H "Authorization: Bearer $INCANTORY_TOKEN"