Skip to main content
GET
Get task detail

Authorizations

X-API-Key
string
header
required

API key for programmatic access. Create one in the Parse dashboard at https://parse.bot (Settings → API Keys). Keys start with 'pmx_'.

Path Parameters

task_id
string
required

Response

200 - application/json

Task detail

id
string
url
string
task
string | null
status
enum<string>

Task lifecycle state. Poll until it reaches a terminal state: completed, failed, or cancelled.

Available options:
queued,
running,
needs_input,
completed,
failed,
cancelled
iteration
integer | null
user_input_prompt
object | null

Present when status is 'needs_input' — the question(s) the agent needs answered. Respond via POST /dispatch/{task_id}.

result_scraper_id
string | null

Set on completion — the scraper_id used to execute endpoints.

result_marketplace_id
string | null
error
string | null

Set when status is 'failed'.

created_at
string | null
updated_at
string | null
completed_at
string | null
parent_task_id
string | null
extends_scraper_id
string | null
revision_type
string | null
auth_enabled
boolean
default:false

True if this API was built against a site that requires login.

source
enum<string>
default:built

How the user acquired this API.

Available options:
built,
subscribed,
forked
contributes_to_marketplace
boolean
default:true
progress
object

Live build progress while status is 'running' (stage, headline, per-endpoint status, log).

marketplace_apis
object | null
existing_marketplace_apis
object | null
generated_api
object | null