---
title: "Todo"
url: "https://developers.rest.rodeo/apis/todos/versions/7d1617fd-92fe-4136-8be7-b2acec2c30db/schemas/Todo"
---

> Full API specification: https://developers.rest.rodeo/apis/todos/versions/7d1617fd-92fe-4136-8be7-b2acec2c30db.md

# Todo

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Todos API
  version: 1.0.0
servers:
  - url: https://api.rest.rodeo/todos/api/v1
    description: Production
components:
  schemas:
    Todo:
      type: object
      required:
        - id
        - name
        - description
        - dueDate
        - completed
        - createdAt
        - updatedAt
        - completedAt
      additionalProperties: false
      properties:
        id:
          type: string
          format: uuid
          description: The todo id.
        name:
          type: string
          description: The todo name.
          maxLength: 256
          minLength: 1
        description:
          type: string
          description: The todo description.
          maxLength: 2000
        dueDate:
          type: string
          format: date-time
          nullable: true
          description: When the todo is due, or null when it has no due date.
        completed:
          type: boolean
          description: Whether the todo has been completed.
        createdAt:
          type: string
          format: date-time
          description: When the todo was created. This is the billable event.
        updatedAt:
          type: string
          format: date-time
          description: When the todo was last updated.
        completedAt:
          type: string
          format: date-time
          nullable: true
          description: When the todo was completed, or null while it is incomplete.
```