POST /v1/todos/create — todoservice-api · SKMTC Hub

TodoService

CreateTodo creates a new todo item and returns the persisted record with the server-assigned id, created_at, and updated_at populated. Returns INVALID_ARGUMENT if the request payload fails validation.

post/v1/todos/create

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