---
title: "PUT /tasks/:id"
method: PUT
path: "/tasks/:id"
---

# PUT /tasks/:id

`PUT /tasks/:id`

## Request body

- object — Task editable fields.
  - `ignored` unknown
  - `completed` unknown
  - `integration_id` string
  - `distant_task_id` string
  - `integration_data` unknown
  - `occurrence` object — Recurrence information if this task is an occurrence.
    - `date` unknown[] — The date this occurrence was spawned for.
      - unknown
    - `recurrence` string — The parent task that spawned this occurrence.
  - `parent` object — The potential parent object.
    - `kind` union
      - string
      - string
      - string
      - string
      - string
      - string
      - string
    - `id` string
  - `starred` boolean — Whether the task is starred.
  - `notes` object — The task notes.
    - `blocks` union[]
      - union
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `list_type` union
            - string
            - string
          - `content` string
          - `depth` integer
        - object
          - `id` string
          - `type` string
          - `checked` boolean
          - `content` string
          - `depth` integer
        - object
          - `id` string
          - `type` string
          - `language` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `background_color` unknown[]
            - unknown
          - `content` string
          - `icon` object
            - `kind` string
            - `emoji` string
        - object
          - `id` string
          - `type` string
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `content` string
          - `level` integer
          - `retracted` boolean
        - object
          - `id` string
          - `type` string
          - `referee` object
            - `kind` union
              - …
            - `id` string
        - object
          - `id` string
          - `type` string
          - `workspace_id` string
          - `table_id` string
          - `row_id` RowId — unresolved $ref
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `recurrent_task_id` TaskRecId — unresolved $ref
          - `content` string
          - `recurrence` union
            - object
              - …
            - object
              - …
        - object
          - `id` string
          - `type` string
          - `checked` boolean — true if the task has been completed
          - `content` string — title of the task
          - `task` string — ID of the task - should be null for a new todo block. Old documents hold a plain google task id in this field so we need to accept broader values
  - `title` string — The task title.
  - `url` unknown

## Response `200`

The upserted task

- object — A task.
  - `allocations` string[]
  - `client` unknown
  - `created` string
  - `deleted` Time — unresolved $ref
  - `etag` object
    - `time` Time — unresolved $ref
    - `version` integer
  - `id` string
  - `ignored` unknown
  - `completed` unknown
  - `integration_id` string
  - `distant_task_id` string
  - `integration_data` unknown
  - `occurrence` object — Recurrence information if this task is an occurrence.
    - `date` unknown[] — The date this occurrence was spawned for.
      - unknown
    - `recurrence` string — The parent task that spawned this occurrence.
  - `parent` object — The potential parent object.
    - `kind` union
      - string
      - string
      - string
      - string
      - string
      - string
      - string
    - `id` string
  - `starred` boolean — Whether the task is starred.
  - `notes` object — The task notes.
    - `blocks` union[]
      - union
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `list_type` union
            - string
            - string
          - `content` string
          - `depth` integer
        - object
          - `id` string
          - `type` string
          - `checked` boolean
          - `content` string
          - `depth` integer
        - object
          - `id` string
          - `type` string
          - `language` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `background_color` unknown[]
            - unknown
          - `content` string
          - `icon` object
            - `kind` string
            - `emoji` string
        - object
          - `id` string
          - `type` string
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `content` string
          - `level` integer
          - `retracted` boolean
        - object
          - `id` string
          - `type` string
          - `referee` object
            - `kind` union
              - …
            - `id` string
        - object
          - `id` string
          - `type` string
          - `workspace_id` string
          - `table_id` string
          - `row_id` RowId — unresolved $ref
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `content` string
        - object
          - `id` string
          - `type` string
          - `recurrent_task_id` TaskRecId — unresolved $ref
          - `content` string
          - `recurrence` union
            - object
              - …
            - object
              - …
        - object
          - `id` string
          - `type` string
          - `checked` boolean — true if the task has been completed
          - `content` string — title of the task
          - `task` TaskId — unresolved $ref
  - `title` string — The task title.
  - `url` unknown

---

[API](https://skmtc.dev/routine/apis/routine-co.md) · [All operations](https://skmtc.dev/routine/apis/routine-co/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/routine/routine-co/revisions/efced8f8ad00/schema)