TODO for AI API

comment

Endpoint

Comment list

GET

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

/todos/{todoId}/comments

All comment threads of a todo (grouped client-side by messageId), their resolve state, author cards, and what the caller may do. Public todos are readable without auth.

Comment list › path Parameters

todoIdstring · required

Comment list › Responses

Successful response

commentsobject[] · required
threadsobject[] · required
authorsobject[] · required
canCommentboolean · required
What the caller may do — the UI renders from this, never re-derives the ACL.
canModerateboolean · required
commentsEnabledboolean · required

Comment add

POST

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

/todos/{todoId}/comments

Comment on one message of a todo, optionally quoting a text span. Members always may; signed-in outsiders only on a public todo with comments enabled. Never starts the agent.

Comment add › path Parameters

todoIdstring · required

Comment add › Request Body

todoIdstring · minLength: 1 · required
messageIdstring · minLength: 1 · required
contentstring · minLength: 1 · maxLength: 2000 · required

quoteobject

Comment add › Responses

Successful response

idstring · required
todoIdstring · required
messageIdstring · required
The thread: every comment belongs to exactly one message.
authorIdstring · required
contentstring · required
createdAtnumber · required

quoteobject
Where in a message a comment points. Quote-anchored (W3C TextQuoteSelector), not offsets: survives markdown re-rendering; if the quote no longer matches, the comment falls back to the whole message.
editedAtnumber

Comment delete

DELETE

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

/todos/{todoId}/comments/{commentId}

Delete a comment — your own, or any if you can edit the todo.

Comment delete › path Parameters

todoIdstring · required
commentIdstring · required

Comment delete › Request Body

todoIdstring · required
commentIdstring · required

Comment delete › Responses

Successful response

null

Comment edit

PATCH

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

/todos/{todoId}/comments/{commentId}

Edit your own comment within 15 minutes of posting it.

Comment edit › path Parameters

todoIdstring · required
commentIdstring · required

Comment edit › Request Body

todoIdstring · minLength: 1 · required
commentIdstring · minLength: 1 · required
contentstring · minLength: 1 · maxLength: 2000 · required

Comment edit › Responses

Successful response

idstring · required
todoIdstring · required
messageIdstring · required
The thread: every comment belongs to exactly one message.
authorIdstring · required
contentstring · required
createdAtnumber · required

quoteobject
Where in a message a comment points. Quote-anchored (W3C TextQuoteSelector), not offsets: survives markdown re-rendering; if the quote no longer matches, the comment falls back to the whole message.
editedAtnumber

Comment resolve

POST

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

/todos/{todoId}/comments/threads/{messageId}/resolve

Resolve or reopen the comment thread on a message. Editors only.

Comment resolve › path Parameters

todoIdstring · required
messageIdstring · required

Comment resolve › Request Body

todoIdstring · required
messageIdstring · required
resolvedboolean · required

Comment resolve › Responses

Successful response

messageIdstring · required

resolvedAtnumber
resolvedBystring

codex context

Comment list

GET

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

/todos/{todoId}/comments

All comment threads of a todo (grouped client-side by messageId), their resolve state, author cards, and what the caller may do. Public todos are readable without auth.

Comment list › path Parameters

todoIdstring · required

Comment list › Responses

Successful response

commentsobject[] · required
threadsobject[] · required
authorsobject[] · required
canCommentboolean · required
What the caller may do — the UI renders from this, never re-derives the ACL.
canModerateboolean · required
commentsEnabledboolean · required

Comment add

POST

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

/todos/{todoId}/comments

Comment on one message of a todo, optionally quoting a text span. Members always may; signed-in outsiders only on a public todo with comments enabled. Never starts the agent.

Comment add › path Parameters

todoIdstring · required

Comment add › Request Body

todoIdstring · minLength: 1 · required
messageIdstring · minLength: 1 · required
contentstring · minLength: 1 · maxLength: 2000 · required

quoteobject

Comment add › Responses

Successful response

idstring · required
todoIdstring · required
messageIdstring · required
The thread: every comment belongs to exactly one message.
authorIdstring · required
contentstring · required
createdAtnumber · required

quoteobject
Where in a message a comment points. Quote-anchored (W3C TextQuoteSelector), not offsets: survives markdown re-rendering; if the quote no longer matches, the comment falls back to the whole message.
editedAtnumber

Comment delete

DELETE

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

/todos/{todoId}/comments/{commentId}

Delete a comment — your own, or any if you can edit the todo.

Comment delete › path Parameters

todoIdstring · required
commentIdstring · required

Comment delete › Request Body

todoIdstring · required
commentIdstring · required

Comment delete › Responses

Successful response

null

Comment edit

PATCH

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

/todos/{todoId}/comments/{commentId}

Edit your own comment within 15 minutes of posting it.

Comment edit › path Parameters

todoIdstring · required
commentIdstring · required

Comment edit › Request Body

todoIdstring · minLength: 1 · required
commentIdstring · minLength: 1 · required
contentstring · minLength: 1 · maxLength: 2000 · required

Comment edit › Responses

Successful response

idstring · required
todoIdstring · required
messageIdstring · required
The thread: every comment belongs to exactly one message.
authorIdstring · required
contentstring · required
createdAtnumber · required

quoteobject
Where in a message a comment points. Quote-anchored (W3C TextQuoteSelector), not offsets: survives markdown re-rendering; if the quote no longer matches, the comment falls back to the whole message.
editedAtnumber