---
title: "Get a single task by ID"
method: GET
path: "/tasks/{taskId}"
tags: ["Tasks"]
---

# Get a single task by ID

`GET /tasks/{taskId}`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/tasks/{taskId}`
- Auth: HTTP bearer

## Path parameters

- `taskId` string, required

## Query parameters

- `includeControlPermission` boolean

## Response `200`

OK

- TaskReadSchema
  - `control` TaskControlSchema, required
    - `requestId` string, required
    - `action` 'pause' | 'resume' | 'stop', required
    - `status` 'requested' | 'acknowledged' | 'unsupported', required
    - `requestedAt` string, date-time, required
    - `acknowledgedAt` string, date-time, nullable, required
  - `canControl` boolean
  - `canFinish` boolean: With includeControlPermission: true when the caller is the assignee side and may mark the task done or failed.
  - `taskId` string, required
  - `description` string, required
  - `title` string, required
  - `agreementId` string, required
  - `state` string, required
  - `assigneeId` string, nullable, required
  - `assigneePresentation` object
  - `result` object, nullable, required
  - `errorMessage` string, nullable, required
  - `parentTaskId` string, nullable, required
  - `rootTaskId` string, nullable, required
  - `waitsOn` string[], required
  - `heldByDeps` boolean, required
  - `joinKind` 'all' | 'any', required
  - `closesBy` 'result' | 'children', required: How this task closes. `result`: by its own result, handed out to its assignee. `children`: a job, which closes when its children close and is never handed out.
  - `heldByParentReview` boolean, required: True while this task waits for its parent's plan to be acknowledged.
  - `runIf` object, nullable, required: A graph step that runs only if a yes/no question holds over the steps it waits on: the question, and once asked, the outcome (run, skipped, held for the buyer, or run by the buyer) with the answer and why.
  - `plan` object, required
  - `planReview` object, nullable, required
  - `dueAt` string, date-time, nullable, required
  - `checkBack` object, nullable, required
  - `waitingOn` object, nullable, required
  - `userOutcomeSatisfaction` 'positive' | 'negative', nullable, required
  - `userReports` object[], required
  - `history` object[], required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `agreement` TaskAgreementSummarySchema, required
    - `agreementId` string, required
    - `description` string, required
    - `status` string, required
    - `parties` object, required
    - `counterparty` string, nullable, required
  - `creatorIsYou` boolean
  - `taskCreatorIsYou` boolean
  - `providerIsYou` boolean
  - `payerIsYou` boolean
  - `proposedToIsYou` boolean

---

[API](https://skmtc.dev/ziggsai/apis/ziggs-developer-api.md) · [All operations](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ziggsai/apis/ziggs-developer-api/revisions/eda79030e072?raw)