---
title: "Get a task and its messages"
method: GET
path: "/v1/tasks/{taskId}"
tags: ["Adam API"]
---

# Get a task and its messages

`GET /v1/tasks/{taskId}`

## Path parameters

- `taskId` string, uuid, required

## Response `200`

- GetPublicApiTaskResponseDto
  - `task` object, required
    - `id` string, required
    - `title` string, required
    - `status` 'queued' | 'running' | 'awaiting_input' | 'completed' | 'cancelled' | 'failed', required
    - `projectId` string, nullable, required
    - `model` object, required
      - `slug` string, nullable, required
      - `fast` boolean, required
      - `effort` 'low' | 'medium' | 'high' | 'xhigh', nullable, required
    - `pendingInteraction` object, nullable, required
      - `id` string, required
      - `type` 'question' | 'approval', required
      - `prompt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `messages` object[], required
    - `id` string, required
    - `role` 'user' | 'assistant', required
    - `parts` union[], required
      - union
        - object
          - `type` 'reasoning', required
          - `text` string, required
        - object
          - `type` 'text', required
          - `text` string, required
        - object
          - `type` 'file', required
          - `id` string, nullable, required
          - `name` string, nullable, required
          - `mediaType` string, required
          - `downloadUrl` string, uri, required
        - object
          - `type` 'source_url', required
          - `sourceId` string, required
          - `url` string, uri, required
          - `title` string, nullable, required
        - object
          - `type` 'source_document', required
          - `sourceId` string, required
          - `mediaType` string, required
          - `title` string, required
          - `filename` string, nullable, required
        - object
          - `type` 'reasoning_file', required
          - `mediaType` string, required
          - `url` string, uri, required
        - object
          - `type` 'data', required
          - `name` string, required
          - `id` string, nullable, required
          - `data` union, required
            - string
            - number
            - boolean
            - GetPublicApiTaskResponseDtoSchema0[]
            - object
        - object
          - `type` 'custom', required
          - `kind` string, required
          - `providerMetadata` union
            - string
            - number
            - boolean
            - GetPublicApiTaskResponseDtoSchema0[]
            - object
        - object
          - `type` 'step_start', required
        - object
          - `type` 'tool_call', required
          - `toolCallId` string, required
          - `name` string, required
          - `input` union
            - string
            - number
            - boolean
            - GetPublicApiTaskResponseDtoSchema0[]
            - object
        - object
          - `type` 'tool_result', required
          - `toolCallId` string, required
          - `name` string, required
          - `status` 'success', required
          - `output` union
            - string
            - number
            - boolean
            - GetPublicApiTaskResponseDtoSchema0[]
            - object
        - object
          - `type` 'tool_result', required
          - `toolCallId` string, required
          - `name` string, required
          - `status` 'error', required
          - `error` string
        - object
          - `type` 'tool_result', required
          - `toolCallId` string, required
          - `name` string, required
          - `status` 'denied', required
    - `createdAt` string, date-time, required

## Other responses

- `400` — Invalid request
- `401` — Missing or invalid Bearer credential
- `402` — Payment or subscription required
- `403` — Credential is missing a required scope
- `404` — Resource not found
- `409` — Request conflict
- `429` — Rate limit exceeded
- `500` — Internal API error

---

[API](https://skmtc.dev/adam/apis/adam-api.md) · [All operations](https://skmtc.dev/adam/apis/adam-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adam/adam-api/revisions/51dcac1f99da/schema)