TODO for AI API

agentSettings

Endpoint

AgentSettings ensureForSpec

POST

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

/agents/for-spec/{specId}

Returns the user's own agent for a registry spec (template), creating it on first use.

AgentSettings ensureForSpec › path Parameters

specIdstring · required

AgentSettings ensureForSpec › Request Body

specIdstring · required

AgentSettings ensureForSpec › Responses

Successful response

idstring · required
namestring · required
ownerIdstring · required
edgesMcpConfigsobject · required
createdAtnumber · required
updatedAtnumber · required

systemMessagestring
Custom system prompt for the agent
modelstring
LLM model identifier (e.g., 'claude-3-opus')
thinkingLevel
temperaturenumber
systemMessageMode
'default_coder' uses built-in coding prompt, 'custom_w_tools' uses systemMessage + auto-injected capability sections, 'raw' uses systemMessage verbatim (no global prepend, no tool/routing/workspace sections).
smartSystemPromptboolean
Auto-enhance system prompt based on context
memoryEnabledboolean
Put the user's file memory (todoforai:memory/: index + pinned files) in the system prompt. Default on.
contextDocumentsobject[]
Reference files (PDF, images, text/office docs) pinned to every conversation of this agent: sent natively as the first user message (PDF/image as document/image blocks), prompt-cached. Metadata only — the agent fetches bytes by attachment id.
devicesConfigobject
permissionsobject
specIdstring
Spec this agent was created from
colorstring
Hex color (e.g. '#10b981') used to tint todos assigned to this agent

AgentSettings list

GET

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

/agents

Returns AI agent configurations. Optionally filter by workspacePath or name (returns enriched results).

AgentSettings list › Responses

Successful response

idstring · required
namestring · required
ownerIdstring · required
edgesMcpConfigsobject · required
createdAtnumber · required
updatedAtnumber · required

systemMessagestring
Custom system prompt for the agent
modelstring
LLM model identifier (e.g., 'claude-3-opus')
thinkingLevel
temperaturenumber
systemMessageMode
'default_coder' uses built-in coding prompt, 'custom_w_tools' uses systemMessage + auto-injected capability sections, 'raw' uses systemMessage verbatim (no global prepend, no tool/routing/workspace sections).
smartSystemPromptboolean
Auto-enhance system prompt based on context
memoryEnabledboolean
Put the user's file memory (todoforai:memory/: index + pinned files) in the system prompt. Default on.
contextDocumentsobject[]
Reference files (PDF, images, text/office docs) pinned to every conversation of this agent: sent natively as the first user message (PDF/image as document/image blocks), prompt-cached. Metadata only — the agent fetches bytes by attachment id.
devicesConfigobject
permissionsobject
specIdstring
Spec this agent was created from
colorstring
Hex color (e.g. '#10b981') used to tint todos assigned to this agent

AgentSettings create

POST

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

/agents

Creates a new AI agent configuration with default settings.

AgentSettings create › Request Body

AgentSettings create › Responses

Successful response

idstring · required
namestring · required
ownerIdstring · required
edgesMcpConfigsobject · required
createdAtnumber · required
updatedAtnumber · required

systemMessagestring
Custom system prompt for the agent
modelstring
LLM model identifier (e.g., 'claude-3-opus')
thinkingLevel
temperaturenumber
systemMessageMode
'default_coder' uses built-in coding prompt, 'custom_w_tools' uses systemMessage + auto-injected capability sections, 'raw' uses systemMessage verbatim (no global prepend, no tool/routing/workspace sections).
smartSystemPromptboolean
Auto-enhance system prompt based on context
memoryEnabledboolean
Put the user's file memory (todoforai:memory/: index + pinned files) in the system prompt. Default on.
contextDocumentsobject[]
Reference files (PDF, images, text/office docs) pinned to every conversation of this agent: sent natively as the first user message (PDF/image as document/image blocks), prompt-cached. Metadata only — the agent fetches bytes by attachment id.
devicesConfigobject
permissionsobject
specIdstring
Spec this agent was created from
colorstring
Hex color (e.g. '#10b981') used to tint todos assigned to this agent

AgentSettings getGlobal

GET

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

/agents/global

Returns global agent settings defaults for the user.

AgentSettings getGlobal › Responses

Successful response

systemMessagestring
modelstring
thinkingLevel
temperaturenumber
permissionsobject
edgesMcpConfigsobject
devicesConfigobject

AgentSettings updateGlobal

PUT

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

/agents/global

Updates global agent settings defaults for the user.

AgentSettings updateGlobal › Request Body

systemMessagestring
modelstring
thinkingLevel
temperaturenumber
permissionsobject
edgesMcpConfigsobject
devicesConfigobject

AgentSettings updateGlobal › Responses

Successful response

systemMessagestring
modelstring
thinkingLevel
temperaturenumber
permissionsobject
edgesMcpConfigsobject
devicesConfigobject

AgentSettings get

GET

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

/agents/{agentSettingsId}

Returns a specific AI agent configuration.

AgentSettings get › path Parameters

agentSettingsIdstring · required

AgentSettings get › Responses

Successful response

idstring · required
namestring · required
ownerIdstring · required
edgesMcpConfigsobject · required
createdAtnumber · required
updatedAtnumber · required

systemMessagestring
Custom system prompt for the agent
modelstring
LLM model identifier (e.g., 'claude-3-opus')
thinkingLevel
temperaturenumber
systemMessageMode
'default_coder' uses built-in coding prompt, 'custom_w_tools' uses systemMessage + auto-injected capability sections, 'raw' uses systemMessage verbatim (no global prepend, no tool/routing/workspace sections).
smartSystemPromptboolean
Auto-enhance system prompt based on context
memoryEnabledboolean
Put the user's file memory (todoforai:memory/: index + pinned files) in the system prompt. Default on.
contextDocumentsobject[]
Reference files (PDF, images, text/office docs) pinned to every conversation of this agent: sent natively as the first user message (PDF/image as document/image blocks), prompt-cached. Metadata only — the agent fetches bytes by attachment id.
devicesConfigobject
permissionsobject
specIdstring
Spec this agent was created from
colorstring
Hex color (e.g. '#10b981') used to tint todos assigned to this agent

AgentSettings delete

DELETE

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

/agents/{agentSettingsId}

Permanently deletes an AI agent configuration.

AgentSettings delete › path Parameters

agentSettingsIdstring · required

AgentSettings delete › Request Body

agentSettingsIdstring · required

AgentSettings delete › Responses

Successful response

null

AgentSettings reorder

PUT

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

/agents/reorder

Updates the display order of agent configurations.

AgentSettings reorder › Request Body

agentSettingsIdsstring[] · required

AgentSettings reorder › Responses

Successful response

null

AgentSettings update

PUT

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

/agents/{agentSettingsId}/settings

Updates AI agent settings like model, temperature, and system prompt.

AgentSettings update › path Parameters

agentSettingsIdstring · required

AgentSettings update › Request Body

agentSettingsIdstring · required
updatesobject · required
Make all properties in T optional

AgentSettings update › Responses

Successful response

idstring · required
namestring · required
ownerIdstring · required
edgesMcpConfigsobject · required
createdAtnumber · required
updatedAtnumber · required

systemMessagestring
Custom system prompt for the agent
modelstring
LLM model identifier (e.g., 'claude-3-opus')
thinkingLevel
temperaturenumber
systemMessageMode
'default_coder' uses built-in coding prompt, 'custom_w_tools' uses systemMessage + auto-injected capability sections, 'raw' uses systemMessage verbatim (no global prepend, no tool/routing/workspace sections).
smartSystemPromptboolean
Auto-enhance system prompt based on context
memoryEnabledboolean
Put the user's file memory (todoforai:memory/: index + pinned files) in the system prompt. Default on.
contextDocumentsobject[]
Reference files (PDF, images, text/office docs) pinned to every conversation of this agent: sent natively as the first user message (PDF/image as document/image blocks), prompt-cached. Metadata only — the agent fetches bytes by attachment id.
devicesConfigobject
permissionsobject
specIdstring
Spec this agent was created from
colorstring
Hex color (e.g. '#10b981') used to tint todos assigned to this agent

AgentSettings updateEdgeMCPConfig

PUT

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

/agents/{agentSettingsId}/edge-mcp-config

Updates MCP server activation state for an edge device.

AgentSettings updateEdgeMCPConfig › path Parameters

agentSettingsIdstring · required

AgentSettings updateEdgeMCPConfig › Request Body

agentSettingsIdstring · required
edgeIdstring · required
mcpNamestring · required
configobject · required

AgentSettings updateEdgeMCPConfig › Responses

Successful response

null

AgentSettings updateDeviceConfig

PUT

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

/agents/{agentSettingsId}/device-config

Updates per-agent config (workspacePaths, enabled) for a bridge device.

AgentSettings updateDeviceConfig › path Parameters

agentSettingsIdstring · required

AgentSettings updateDeviceConfig › Request Body

agentSettingsIdstring · required
deviceIdstring · required
configobject · required
Make all properties in T optional

AgentSettings updateDeviceConfig › Responses

Successful response

null

adminUser apiKey