Update a Raycast task

curl --fail-with-body --silent --show-error \
  -X PATCH \
  "https://api.getkato.io/v1/raycast/tasks/$KATO_TASK_ID" \
  -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "priority": "high",
  "dueDate": null
}'

{
  "data": {
    "id": "task_example",
    "title": "Prepare kickoff",
    "description": null,
    "status": "todo",
    "priority": "no_priority",
    "assignees": [],
    "dueDate": null,
    "timeLogged": 0,
    "estimatedTime": null,
    "createdBy": "user_example",
    "createdAt": "2026-09-07T12:00:00.000Z",
    "updatedAt": "2026-09-07T12:00:00.000Z",
    "linkedMeetingIds": [],
    "fileCount": 0,
    "linkedRecordCount": 0,
    "timerState": null,
    "webUrl": "https://app.getkato.io/northlane/tasks/task_example/details"
  }
}

PATCH

raycast

tasks

{taskId}

curl --fail-with-body --silent --show-error \
  -X PATCH \
  "https://api.getkato.io/v1/raycast/tasks/$KATO_TASK_ID" \
  -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "priority": "high",
  "dueDate": null
}'

{
  "data": {
    "id": "task_example",
    "title": "Prepare kickoff",
    "description": null,
    "status": "todo",
    "priority": "no_priority",
    "assignees": [],
    "dueDate": null,
    "timeLogged": 0,
    "estimatedTime": null,
    "createdBy": "user_example",
    "createdAt": "2026-09-07T12:00:00.000Z",
    "updatedAt": "2026-09-07T12:00:00.000Z",
    "linkedMeetingIds": [],
    "fileCount": 0,
    "linkedRecordCount": 0,
    "timerState": null,
    "webUrl": "https://app.getkato.io/northlane/tasks/task_example/details"
  }
}

Update a visible task, including its record links, meeting links, or section. Use an OAuth access token issued to kato-raycast. Developer keys cannot call this endpoint. See Raycast authentication. Required scopes: tasks:write. Supply at least one recognized change. Omitted values remain unchanged. Null clears dueDate, estimatedTime, or sectionId. If sectionId is supplied together with linkedRecordIds, include the section’s record in the links. Invalid targets return 400; inaccessible or archived tasks return 404.

Parameters

string

required

Task ID accessible to the key owner.

string

Trimmed 1–500 characters.

string

Up to 100,000 characters.

string

Workspace status slug from the Raycast status endpoint.

string

no_priority, low, medium, high, or urgent.

string | null

ISO 8601 datetime, or null. This differs from developer task writes.

string[]

Up to 50 workspace auth-user IDs, each 1–200 characters. Supplied arrays replace the current selection; [] clears it.

integer | null

Positive minutes, maximum 525,600. Null clears the value.

string[]

Up to 10 accessible record IDs. Supplied arrays replace the current selection; [] clears it.

string[]

Up to 10 accessible native meeting IDs. Supplied arrays replace the current selection; [] clears it.

string | null

Task section ID, 1–200 characters. Null clears the value.

Response

200 — Returns the resource under data. Example IDs and values are illustrative.

{
  "data": {
    "id": "task_example",
    "title": "Prepare kickoff",
    "description": null,
    "status": "todo",
    "priority": "no_priority",
    "assignees": [],
    "dueDate": null,
    "timeLogged": 0,
    "estimatedTime": null,
    "createdBy": "user_example",
    "createdAt": "2026-09-07T12:00:00.000Z",
    "updatedAt": "2026-09-07T12:00:00.000Z",
    "linkedMeetingIds": [],
    "fileCount": 0,
    "linkedRecordCount": 0,
    "timerState": null,
    "webUrl": "https://app.getkato.io/northlane/tasks/task_example/details"
  }
}

curl --fail-with-body --silent --show-error \
  -X PATCH \
  "https://api.getkato.io/v1/raycast/tasks/$KATO_TASK_ID" \
  -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "priority": "high",
  "dueDate": null
}'

Set path-ID environment variables to values returned by your workspace before running the request. This request changes workspace data. A timeout does not prove that the write failed; inspect the result before retrying.

API Reference

Developer identity

Objects and records

Tasks

Webhooks

CLI API

Raycast API

Raycast identity and discovery

Raycast tasks

Raycast records

Raycast meetings and activity

Raycast notifications

OAuth

Update a Raycast task

Parameters

Response

​Parameters

​Response

Parameters

Response