Stars API

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

Star a make (idempotent)

POST/api/v1/makes/{slug}/starToken required · scope write

Returns { starred, starCount }. Starring twice is not an error and never double-counts. Unlike the other make writes, a plain write token may star (stars are §13 API writes). A make you cannot read answers 404.

starMake parameters
Name	Type	Description
`slug` pathrequired	`string`	Make slug (global)

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

Response fields

starMake response fields
Name	Type	Description
`starred`required	`boolean`
`starCount`required	`integer (-9007199254740991–9007199254740991)`

Example

curl -X POST 'https://incantory.ai/api/v1/makes/{slug}/star' \
  -H "Authorization: Bearer $INCANTORY_TOKEN"

Remove your star from a make (idempotent)

DELETE/api/v1/makes/{slug}/starToken required · scope write

unstarMake parameters
Name	Type	Description
`slug` pathrequired	`string`	Make slug (global)

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

Response fields

unstarMake response fields
Name	Type	Description
`starred`required	`boolean`
`starCount`required	`integer (-9007199254740991–9007199254740991)`

Example

curl -X DELETE 'https://incantory.ai/api/v1/makes/{slug}/star' \
  -H "Authorization: Bearer $INCANTORY_TOKEN"

Your starred prompts, newest star first

GET/api/v1/me/starsToken required · scope read

listMyStars parameters
Name	Type	Description
`cursor` query	`string`
`limit` query	`integer (1–100)`

Responses: 200 OK304, 400, 401, 403, 404, 429

Response fields

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

Example

curl 'https://incantory.ai/api/v1/me/stars' \
  -H "Authorization: Bearer $INCANTORY_TOKEN"

Star a prompt (idempotent)

POST/api/v1/prompts/{owner}/{slug}/starToken required · scope write

Returns { starred, starCount }. Starring twice is not an error and never double-counts.

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

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

Response fields

starPrompt response fields
Name	Type	Description
`starred`required	`boolean`
`starCount`required	`integer (-9007199254740991–9007199254740991)`

Example

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

Remove your star (idempotent)

DELETE/api/v1/prompts/{owner}/{slug}/starToken required · scope write

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

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

Response fields

unstarPrompt response fields
Name	Type	Description
`starred`required	`boolean`
`starCount`required	`integer (-9007199254740991–9007199254740991)`

Example

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