> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Raycast task details

> Load a visible task with profiles, related records, meetings, files, and activity.

Load a visible task with profiles, related records, meetings, files, and activity.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `tasks:read`.

Uses live role-based task visibility, rather than restricting detail access to the assigned-to-me list. Missing, archived, or inaccessible tasks return `404`. Meeting details respect sharing levels. Activity is limited to the newest 30 entries; comments are the comment subset of that activity.

## Parameters

<ParamField path="taskId" type="string" required>
  Task ID accessible to the key owner.
</ParamField>

## Response

**200** — The [task summary](/api-reference/raycast/models#tasks) with `assigneeProfiles`, `createdByProfile`, `linkedRecords`, `linkedMeetings`, `section`, `activity`, `comments`, and `files`.

<ResponseExample>
  ```json 200 theme={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",
      "assigneeProfiles": [],
      "createdByProfile": null,
      "linkedRecords": [],
      "linkedMeetings": [],
      "section": null,
      "activity": [],
      "comments": [],
      "files": []
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    "https://api.getkato.io/v1/raycast/tasks/$KATO_TASK_ID" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN"
  ```
</RequestExample>

Set path-ID environment variables to values returned by your workspace before running the request.


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [Get task creation options](/api-reference/raycast/task-options.md)
- [Get entity activity](/api-reference/raycast/activity.md)
- [Raycast API](/api-reference/raycast/overview.md)
- [Get the daily brief](/api-reference/raycast/brief.md)