GOgo-kratos
TodoService

POST /v1/todos/create

Changed on

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.

Request

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

  • bbd5b5339910Revision changes
    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • d99daada47f9Revision changes
    • info

      endpoint added