Watch API

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

Your watch level (none when signed out)

GET/api/v1/prompts/{owner}/{slug}/watchToken optional

getWatch parameters
Name	Type	Description
`owner` pathrequired	`string`	Owner handle
`slug` pathrequired	`string`	Prompt slug

Responses: 200 OK400, 404, 429

Response fields

getWatch response fields
Name	Type	Description
`level`required	`"none" \| "releases" \| "all" \| "ignore"`

Example

curl 'https://incantory.ai/api/v1/prompts/{owner}/{slug}/watch' \
  -H "Authorization: Bearer $INCANTORY_TOKEN"

Set your watch level

PUT/api/v1/prompts/{owner}/{slug}/watchToken required · scope write

releases: new versions and label moves. all: plus makes, examples, comments and change requests. ignore: nothing. none: stop watching.

setWatch parameters
Name	Type	Description
`owner` pathrequired	`string`	Owner handle
`slug` pathrequired	`string`	Prompt slug

Request body

setWatch body fields
Name	Type	Description
`level`required	`"none" \| "releases" \| "all" \| "ignore"`

Responses: 200 OK400, 401, 403, 404, 429

Response fields

setWatch response fields
Name	Type	Description
`level`required	`"none" \| "releases" \| "all" \| "ignore"`

Example

curl -X PUT 'https://incantory.ai/api/v1/prompts/{owner}/{slug}/watch' \
  -H "Authorization: Bearer $INCANTORY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"level":"none"}'