/todos/{todoId}
Replaces the todo’s name, description, and dueDate. Omitting dueDate clears it. Optionally toggles completed; the server sets completedAt to the update time when the todo flips to complete and clears it when it flips back to incomplete. Bumps updatedAt to the update time.
put
https://api.rest.rodeo/todos/api/v1/todos/{todoId}
Path Parameters
todoIdstring(uuid)required
The todo id.
Body
application/json
Body
application/json
TodoUpdateRequest
* Additional properties are NOT allowed.
namestringrequired
The todo name.
>= 1 characters<= 256 characters
descriptionstringrequired
The todo description.
<= 2000 characters
dueDatestring(date-time)
When the todo is due. Optional; omitting it clears the due date.
completedboolean
Whether the todo has been completed. Optional; omitting it leaves the completion state unchanged.
Response
application/json
Response
application/json
The updated todo
Todo
* Additional properties are NOT allowed.
idstring(uuid)required
The todo id.
namestringrequired
The todo name.
>= 1 characters<= 256 characters
descriptionstringrequired
The todo description.
<= 2000 characters
dueDatestring | null(date-time)required
When the todo is due, or null when it has no due date.
completedbooleanrequired
Whether the todo has been completed.
createdAtstring(date-time)required
When the todo was created. This is the billable event.
updatedAtstring(date-time)required
When the todo was last updated.
completedAtstring | null(date-time)required
When the todo was completed, or null while it is incomplete.
put/todos/{todoId}
Authentication
Path Parameters
Body
{
"name": "Book the rodeo",
"description": "Seats are reserved for the weekend show.",
"dueDate": "2026-10-16T17:00:00.000Z",
"completed": true
}
application/json
/todos/{todoId}
Deletes the todo. Deleting a todo is not billable and does not remove previously recorded usage.
delete
https://api.rest.rodeo/todos/api/v1/todos/{todoId}
Path Parameters
todoIdstring(uuid)required
The todo id.
Response
Response
The todo was deleted
delete/todos/{todoId}
Authentication
Path Parameters
Todo
object * Additional properties are NOT allowed.
idstring(uuid)required
The todo id.
namestringrequired
The todo name.
>= 1 characters<= 256 characters
descriptionstringrequired
The todo description.
<= 2000 characters
dueDatestring(date-time)required
When the todo is due, or null when it has no due date.
completedbooleanrequired
Whether the todo has been completed.
createdAtstring(date-time)required
When the todo was created. This is the billable event.
updatedAtstring(date-time)required
When the todo was last updated.
completedAtstring(date-time)required
When the todo was completed, or null while it is incomplete.
Example
TodoRequest
object * Additional properties are NOT allowed.
namestringrequired
The todo name.
>= 1 characters<= 256 characters
descriptionstringrequired
The todo description.
<= 2000 characters
dueDatestring(date-time)
When the todo is due. Optional; omit or send null for no due date.
Example
TodoUpdateRequest
object * Additional properties are NOT allowed.
namestringrequired
The todo name.
>= 1 characters<= 256 characters
descriptionstringrequired
The todo description.
<= 2000 characters
dueDatestring(date-time)
When the todo is due. Optional; omitting it clears the due date.
completedboolean
Whether the todo has been completed. Optional; omitting it leaves the completion state unchanged.
Example