TODO for AI API

todoRegistry

Endpoint

TodoRegistry listTemplates

GET

https://api.todofor.ai/api/v1

/registry/templates

List all todo specs (templates). Optionally filter by category.

TodoRegistry listTemplates › Responses

Successful response

namestring · required
descriptionstring · required
idstring · required
bodystring · required
The agent prompt body (markdown) — split into system/user via splitTemplateBody.
sourcerequired
Who owns a spec's content. 'builtin' = seeded from todo-registry.json and refreshed on deploy; editing copies-on-write to 'authored' (user-owned, never reseeded). Fork provenance lives in forkedFrom, not here.
updatedAtnumber · required
createdAtnumber · required
categoriesstring[] · required

shortstring
requirementsstring[]
Capability requirements, e.g. "cli:gh", "extension:chrome".
agentConfigobject
Agent settings a spec pins on the agent it starts with (applied by startFromSpec on every start). name/color make it a named agent (default name: the spec name). privatePrompt: the spec's system part stays server-side — stripped from public spec responses and never copied onto the agent; injected at run time via agent.specId.
forkedFromstring
Spec id or todo id this was forked from (set by share / save-as-template).

TodoRegistry createTemplate

POST

https://api.todofor.ai/api/v1

/registry/templates

Create a todo spec in the registry (auth required). Returns the stored spec; its id is what todoforai-cli recommend references. Used by todoregistry-cli create.

TodoRegistry createTemplate › Request Body

namestring · minLength: 1 · maxLength: 120 · required
descriptionstring · minLength: 1 · required
bodystring · minLength: 1 · required
The agent prompt body (markdown).

shortstring
categoriesstring[]
requirementsstring[]
agentConfigobject
Agent settings a spec pins on the agent it starts with (applied by startFromSpec on every start). name/color make it a named agent (default name: the spec name). privatePrompt: the spec's system part stays server-side — stripped from public spec responses and never copied onto the agent; injected at run time via agent.specId.
visibility

TodoRegistry createTemplate › Responses

Successful response

idstring · required
namestring · required
descriptionstring · required
categoriesstring[] · required
bodystring · required
The agent prompt body (markdown) — split into system/user via splitTemplateBody.
sourcerequired
Who owns a spec's content. 'builtin' = seeded from todo-registry.json and refreshed on deploy; editing copies-on-write to 'authored' (user-owned, never reseeded). Fork provenance lives in forkedFrom, not here.
visibilityrequired
createdBystring · required
createdAtnumber · required
updatedAtnumber · required

shortstring
requirementsstring[]
Capability requirements, e.g. "cli:gh", "extension:chrome".
agentConfigobject
Agent settings a spec pins on the agent it starts with (applied by startFromSpec on every start). name/color make it a named agent (default name: the spec name). privatePrompt: the spec's system part stays server-side — stripped from public spec responses and never copied onto the agent; injected at run time via agent.specId.
forkedFromstring
Spec id or todo id this was forked from (set by share / save-as-template).

TodoRegistry getTemplate

GET

https://api.todofor.ai/api/v1

/registry/templates/{id}

Get a single todo spec by ID.

TodoRegistry getTemplate › path Parameters

idstring · required

TodoRegistry getTemplate › Responses

Successful response

namestring · required
descriptionstring · required
idstring · required
bodystring · required
The agent prompt body (markdown) — split into system/user via splitTemplateBody.
sourcerequired
Who owns a spec's content. 'builtin' = seeded from todo-registry.json and refreshed on deploy; editing copies-on-write to 'authored' (user-owned, never reseeded). Fork provenance lives in forkedFrom, not here.
updatedAtnumber · required
createdAtnumber · required
categoriesstring[] · required

shortstring
requirementsstring[]
Capability requirements, e.g. "cli:gh", "extension:chrome".
agentConfigobject
Agent settings a spec pins on the agent it starts with (applied by startFromSpec on every start). name/color make it a named agent (default name: the spec name). privatePrompt: the spec's system part stays server-side — stripped from public spec responses and never copied onto the agent; injected at run time via agent.specId.
forkedFromstring
Spec id or todo id this was forked from (set by share / save-as-template).

TodoRegistry patchTemplate

PATCH

https://api.todofor.ai/api/v1

/registry/templates/{id}

Edit a todo spec. Editing a builtin copies-on-write to an authored spec under the same id.

TodoRegistry patchTemplate › path Parameters

idstring · required

TodoRegistry patchTemplate › Request Body

idstring · required

namestring
descriptionstring
bodystring
shortstring
categoriesstring[]
requirementsstring[]
agentConfigobject
Agent settings a spec pins on the agent it starts with (applied by startFromSpec on every start). name/color make it a named agent (default name: the spec name). privatePrompt: the spec's system part stays server-side — stripped from public spec responses and never copied onto the agent; injected at run time via agent.specId.
visibility

TodoRegistry patchTemplate › Responses

Successful response

idstring · required
namestring · required
descriptionstring · required
categoriesstring[] · required
bodystring · required
The agent prompt body (markdown) — split into system/user via splitTemplateBody.
sourcerequired
Who owns a spec's content. 'builtin' = seeded from todo-registry.json and refreshed on deploy; editing copies-on-write to 'authored' (user-owned, never reseeded). Fork provenance lives in forkedFrom, not here.
visibilityrequired
createdBystring · required
createdAtnumber · required
updatedAtnumber · required

shortstring
requirementsstring[]
Capability requirements, e.g. "cli:gh", "extension:chrome".
agentConfigobject
Agent settings a spec pins on the agent it starts with (applied by startFromSpec on every start). name/color make it a named agent (default name: the spec name). privatePrompt: the spec's system part stays server-side — stripped from public spec responses and never copied onto the agent; injected at run time via agent.specId.
forkedFromstring
Spec id or todo id this was forked from (set by share / save-as-template).

TodoRegistry listPacks

GET

https://api.todofor.ai/api/v1

/registry/packs/list

List all TODO packs.

TodoRegistry listPacks › Responses

Successful response

idstring · required
namestring · required
descriptionstring · required
todoIdsstring[] · required
createdAtnumber · required
updatedAtnumber · required

shortstring
categoriesstring[]

TodoRegistry getAllStats

GET

https://api.todofor.ai/api/v1

/registry/stats

Retrieves statistics for all specs including likes and start counts.

TodoRegistry getAllStats › Responses

Successful response

idstring · required
startsnumber · required
Times started/forked
likesnumber · required
completionRatenumber · required
0-100
avgCompletionTimenumber · required
In milliseconds
isLikedboolean · required
Current user has liked

TodoRegistry getStats

GET

https://api.todofor.ai/api/v1

/registry/{id}/stats

Retrieves statistics for a specific spec.

TodoRegistry getStats › path Parameters

idstring · required

TodoRegistry getStats › Responses

Successful response

idstring · required
startsnumber · required
Times started/forked
likesnumber · required
completionRatenumber · required
0-100
avgCompletionTimenumber · required
In milliseconds
isLikedboolean · required
Current user has liked

TodoRegistry toggleLike

POST

https://api.todofor.ai/api/v1

/registry/{id}/like

Toggles the like status of a spec for the current user.

TodoRegistry toggleLike › path Parameters

idstring · required

TodoRegistry toggleLike › Request Body

idstring · required

TodoRegistry toggleLike › Responses

Successful response

idstring · required
startsnumber · required
Times started/forked
likesnumber · required
completionRatenumber · required
0-100
avgCompletionTimenumber · required
In milliseconds
isLikedboolean · required
Current user has liked

TodoRegistry getAllPackStats

GET

https://api.todofor.ai/api/v1

/registry/packs/stats

Retrieves statistics for all todo packs including likes.

TodoRegistry getAllPackStats › Responses

Successful response

idstring · required
likesnumber · required
isLikedboolean · required

TodoRegistry getAllTemplateMeta

GET

https://api.todofor.ai/api/v1

/registry/meta

Aggregated usage metadata (runs, messages, cost) for all specs.

TodoRegistry getAllTemplateMeta › Responses

Successful response

idstring · required
todoCountnumber · required
How many TODOs created from this spec
messageCountnumber · required
Total messages across all TODOs
totalCostnumber · required
Total cost across all TODOs (USD)
totalDurationnumber · required
Total AI processing duration across all TODOs (ms), summed from RunMeta.elapsed

TodoRegistry togglePackLike

POST

https://api.todofor.ai/api/v1

/registry/packs/{id}/like

Toggles the like status of a todo pack for the current user.

TodoRegistry togglePackLike › path Parameters

idstring · required

TodoRegistry togglePackLike › Request Body

idstring · required

TodoRegistry togglePackLike › Responses

Successful response

idstring · required
likesnumber · required
isLikedboolean · required

todo toolOauth