---
title: "Get task detail"
method: GET
path: "/dispatch/tasks/{task_id}"
tags: ["Dispatch"]
---

# Get task detail

`GET /dispatch/tasks/{task_id}`

Get full details for a dispatch task, including the generated API spec with endpoint definitions and execution URLs when completed.

## Path parameters

- `task_id` string, required

## Response `200`

Task detail

- TaskDetail
  - `id` string
  - `url` string
  - `task` string, nullable
  - `status` 'queued' | 'running' | 'needs_input' | 'completed' | 'failed' | 'cancelled' — Task lifecycle state. Poll until it reaches a terminal state: completed, failed, or cancelled.
  - `iteration` integer, nullable
  - `user_input_prompt` object, nullable — Present when status is 'needs_input' — the question(s) the agent needs answered. Respond via POST /dispatch/{task_id}.
  - `result_scraper_id` string, nullable — Set on completion — the scraper_id used to execute endpoints.
  - `result_marketplace_id` string, nullable
  - `error` string, nullable — Set when status is 'failed'.
  - `created_at` string, nullable
  - `updated_at` string, nullable
  - `completed_at` string, nullable
  - `parent_task_id` string, nullable
  - `extends_scraper_id` string, nullable
  - `revision_type` string, nullable
  - `auth_enabled` boolean — True if this API was built against a site that requires login.
  - `source` 'built' | 'subscribed' | 'forked' — How the user acquired this API.
  - `contributes_to_marketplace` boolean
  - `progress` object — Live build progress while status is 'running' (stage, headline, per-endpoint status, log).
  - `marketplace_apis` object, nullable
  - `existing_marketplace_apis` object, nullable
  - `generated_api` GeneratedAPI
    - `marketplace_id` string
    - `scraper_id` string
    - `name` string
    - `description` string, nullable
    - `source_url` string
    - `execution_base_url` string — Base URL for executing endpoints: {execution_base_url}/{endpoint_name}
    - `endpoints` EndpointSpec[]
      - `method` string — HTTP method (GET, POST, etc.)
      - `endpoint_name` string — Endpoint path segment
      - `description` string
      - `input_params` object
      - `return_schema` object
      - `initiates_session` boolean — True for a login endpoint that returns a session — see Authenticated APIs.

---

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