TodoService

PUT /v1/todos/update

Changed on Aug 15, 2026

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.

Request

The document declares no server URL.
Auth
none declared
TypeScript
https://skmtc.dev/go-kratos/apis/todoservice-api/docs/v1/todos/update/put.ts
A function with typed inputs. Its response is checked against the schema.

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