PUT /v1/todos/update — todoservice-api · SKMTC Hub

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

OK

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.

Changes

Changed in 3 of the 6 revisions of this API.147

Aug 15, 2026bbd5b533991046See the full diff
- ●
  removed the request property
  request-property-removed
- ●
  removed the request property
  request-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
Jun 18, 2026d99daada47f91See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Dec 27, 202152ca3c9327fd1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog