PUT /v1/todos/update — todoservice-api

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-157413.3 KB

bbd5b5339910

TodoService

UpdateTodo applies a partial update to an existing todo item using a FieldMask. Only the fields listed in update_mask are overwritten; all other fields are left unchanged. Returns NOT_FOUND if the target todo does not exist, or INVALID_ARGUMENT if update_mask references unknown fields.

put/v1/todos/update

Query parameters

updateMaskstring field-mask

Set of field paths in todo to overwrite. Fields not listed are left unchanged. Use a single path of * to replace every mutable field.

Request body

idstring

Application-generated UUIDv7 identifier. Read-only on create.

titlestring

Short human-readable title.

contentstring

Detailed description or notes for the todo item.

completedboolean

Whether the todo item has been completed.

createdAtstring date-time

Time at which the todo item was created. Server-assigned, read-only.

updatedAtstring date-time

Time at which the todo item was last modified. Server-assigned, read-only.

statusinteger

Lifecycle state. Server-assigned, read-only: call DeleteTodo to move an item to TODO_STATUS_DELETED.

Response