Todo

Create todo item

Changed on

Create a new todo item.

post/v1/todos

Request

  • Base URL: https://example.com/api
  • URL: https://example.com/api/v1/todos
  • Auth: OAuth 2 (authorization code, authorization URL /oauth/authorize, token URL /oauth/token; client credentials, token URL /oauth/token; password, token URL /oauth/token, scopes: todo)

Request body

titlestring required

Title of the todo item.

descriptionstring nullable

Description of the todo item.

priority'normal' | 'important' | 'urgent' | 'critical' required

Priority of the todo item.

owned_bystring required

ID of the user who owns the todo item.

due_datestring date-time nullable

Completion due date of the todo item.

Example request

{
  "title": "Do something great",
  "description": "I'll make the world a better place today.",
  "priority": "urgent"
}

Response

Example response

idstring required

ID of the newly created resource.

Changes

  • 8a34c0b5508eRevision changes
    • info

      added the non-success 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

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1057260fde29Revision changes
    • info

      api tag Todo added

    • info

      api tag Todos removed