> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getarca.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Get task
> Returns a single task with full details including its status, assignees, labels, and attachments.
Requires the `tasks:read` scope. You must be a member of the task's workspace.
Access-restricted members receive `403` if the task belongs to a list outside
their permitted scope.
## Path parameters
The numeric task ID.
## Response
Task identifier.
Workspace this task belongs to.
List this task belongs to. `null` if not in a list.
Task title.
Task description as an HTML string. `null` if not set.
Task priority. One of `urgent`, `high`, `medium`, `low`, or `none`.
Workspace-scoped sequential task number.
UTC ISO-8601 due date. `null` if not set.
UTC ISO-8601 start date. `null` if not set.
User ID of the task creator.
UTC ISO-8601 creation timestamp.
Current task status. `null` if no status is assigned.
Status identifier.
Status label (e.g., `"In Progress"`).
Icon associated with the status.
Color associated with the status.
Status category. One of `pending`, `in_progress`, `completed`, or `cancelled`.
Array of users assigned to the task. Empty array if unassigned.
User ID.
Display name.
Profile picture URL.
Labels attached to the task. Empty array if no labels are assigned.
Label identifier.
Label name.
Display color of the label. `null` if no color is set.
Direct subtasks of this task. Empty array if the task has no subtasks.
Subtask identifier.
Subtask title.
Subtask priority. One of `urgent`, `high`, `medium`, `low`, or `none`.
Workspace-scoped sequential task number.
Current status of the subtask. `null` if no status is assigned. Same shape as the parent task `status` field.
Users assigned to the subtask. Same shape as the parent task `assignees` array.
Confirmed file attachments on the task. Empty array if none.
Attachment identifier.
Original file name.
File size in bytes.
MIME type (e.g., `"image/png"`).
UTC ISO-8601 upload timestamp.
User who uploaded the file.
User ID.
Display name.
Profile picture URL.
Custom fields that apply to this task's list, each with its current value. Fields restricted to other lists or folders are not returned. Fields the user does not have access to are also omitted.
Custom field identifier.
Custom field name (e.g., `"Customer Tier"`).
Field type. One of `text`, `number`, `date`, `checkbox`, `rating`, `dropdown`, `money`, or `people`.
Type-specific configuration.
For example:
* `rating` fields include `icon` and `color`;
* `dropdown` fields include an `options` array of strings;
* `money` fields include `currency` and `decimals`.
It's `null` for field types with no configuration (which are `text`, `number`, `date`, `checkbox` and `people`).
Sort position of the field within the workspace.
The task's value for this field. `null` when no value has been set.
```json 200 theme={null}
{
"id": 101,
"workspace_id": 3,
"list_id": 20,
"title": "Set up CI pipeline",
"description": "Use GitHub Actions for the build pipeline.
",
"priority": "high",
"identifier": 5,
"due_date": "2026-03-25T00:00:00.000Z",
"start_date": null,
"creator_id": 1,
"created_at": "2026-03-10T14:22:00.000Z",
"status": {
"id": 2,
"name": "In Progress",
"icon": "in-progress",
"color": "blue",
"category": "in_progress"
},
"assignees": [
{
"id": 7,
"name": "Bob",
"avatar_url": "https://cdn.example.com/avatars/bob.png"
}
],
"labels": [
{
"id": 2,
"name": "Backend",
"color": "purple"
}
],
"subtasks": [
{
"id": 102,
"title": "Write unit tests",
"priority": "medium",
"identifier": 6,
"status": {
"id": 1,
"name": "Backlog",
"icon": null,
"color": "gray",
"category": "pending"
},
"assignees": []
}
],
"attachments": [
{
"id": 4,
"file_name": "diagram.png",
"file_size": 204800,
"mime_type": "image/png",
"created_at": "2026-03-11T09:00:00.000Z",
"uploader": {
"id": 1,
"name": "Alice",
"avatar_url": null
}
}
],
"custom_fields": [
{
"id": 1,
"name": "Customer Tier",
"type": "dropdown",
"config": { "options": ["Free", "Starter", "Pro"] },
"position": 1,
"value": "Pro"
},
{
"id": 2,
"name": "Story Points",
"type": "number",
"config": null,
"position": 2,
"value": null
}
]
}
```
```json 401 theme={null}
{
"error": "Invalid API key"
}
```
```json 403 theme={null}
{
"error": "Scope 'tasks:read' is required for this endpoint"
}
```
```json 404 theme={null}
{
"error": "Task not found"
}
```