TODO for AI API

attachment

Endpoint

Attachment get

GET

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

/attachments/{attachmentId}

Retrieves attachment metadata by its unique identifier.

Attachment get › path Parameters

attachmentIdstring · required

Attachment get › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

Attachment delete

DELETE

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

/attachments/{attachmentId}

Permanently deletes an attachment and its associated file.

Attachment delete › path Parameters

attachmentIdstring · required

Attachment delete › Request Body

attachmentIdstring · required

Attachment delete › Responses

Successful response

null

Attachment getByTodo

GET

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

/attachments/todo/{todoId}

Returns all attachments associated with a specific todo item.

Attachment getByTodo › path Parameters

todoIdstring · required

Attachment getByTodo › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

Attachment getByAgent

GET

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

/attachments/agent/{agentSettingsId}

Returns all attachments associated with a specific agent settings.

Attachment getByAgent › path Parameters

agentSettingsIdstring · required

Attachment getByAgent › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

Attachment getByUser

GET

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

/attachments/user/{userId}

Returns all attachments uploaded by the authenticated user.

Attachment getByUser › path Parameters

userIdstring · required

Attachment getByUser › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

apiKey auth

Attachment get

GET

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

/attachments/{attachmentId}

Retrieves attachment metadata by its unique identifier.

Attachment get › path Parameters

attachmentIdstring · required

Attachment get › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

Attachment delete

DELETE

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

/attachments/{attachmentId}

Permanently deletes an attachment and its associated file.

Attachment delete › path Parameters

attachmentIdstring · required

Attachment delete › Request Body

attachmentIdstring · required

Attachment delete › Responses

Successful response

null

Attachment getByTodo

GET

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

/attachments/todo/{todoId}

Returns all attachments associated with a specific todo item.

Attachment getByTodo › path Parameters

todoIdstring · required

Attachment getByTodo › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

Attachment getByAgent

GET

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

/attachments/agent/{agentSettingsId}

Returns all attachments associated with a specific agent settings.

Attachment getByAgent › path Parameters

agentSettingsIdstring · required

Attachment getByAgent › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.

Attachment getByUser

GET

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

/attachments/user/{userId}

Returns all attachments uploaded by the authenticated user.

Attachment getByUser › path Parameters

userIdstring · required

Attachment getByUser › Responses

Successful response

metadataobject · required
idstring · required
uristring · required
Resource URI - always required. Format: "todoforai:todos/{todoId}/{id}"
originalNamestring · required
mimeTypestring · required
fileSizenumber · required
In bytes

userIdstring
Owner user ID
agentSettingsIdstring
Scoped to agent settings
todoIdstring
Scoped to todo
symlinkTostring
If this is a symlink share, the attachment ID of the owner's original file
createdAtnumber
isPublicboolean
status
modifiedAtnumber
Last modified time (mtime), milliseconds epoch
permissionsnumber
Unix permission bits (e.g. 0o644 = 420 decimal)
blockIdstring
Block ID that produced this attachment (for mapping tool results back to tool_calls)
toolCallIdstring
LLM tool_call ID — for stamping results back to the originating tool call
textstring
Agent → backend only: small text results travel inline here instead of a separate binary frame. Consumed at registration; never persisted.