v1

latestOpenAPI 3.0.32026-07-177413.0 KB
TodoService

ListTodos returns a page of todo items, optionally filtered and ordered. Use the next_page_token from TodoSet to retrieve subsequent pages. Returns INVALID_ARGUMENT if filter, order_by, or page_token are malformed.

get/v1/todos/list

Query parameters

pageSizeinteger

Optional. Maximum number of todo items to return in a single page. The server may apply a default and a maximum when unset or out of range.

pageTokenstring

Optional. Token from a previous response's next_page_token used to fetch the next page. Leave empty to request the first page.

filterstring

Optional. The standard list filter. Supported fields: * title (i.e. title:"bug") * content (i.e. content:"docs") * completed (i.e. completed or NOT completed) * create_time range (i.e. create_time>="2026-01-01T00:00:00Z")

orderBystring

Optional. A comma-separated list of fields to order by. Supported fields: * id * title * create_time * update_time Append desc to a field for descending order, e.g. create_time desc. Defaults to ascending order when no direction is supplied.

Response

OK

nextPageTokenstring

Token used to retrieve the next page via ListTodosRequest.page_token. Empty when there are no more results.