Skip to main content
GET
Retrieve Task Group Run

Request contract

  • Method and path: GET /apis/v1/parallel/tasks/groups/{taskgroup_id}/runs/{run_id}
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/parallel/tasks/groups/{taskgroup_id}/runs/{run_id}
  • run_id: path; required
  • taskgroup_id: path; required
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.012 USD per successful request. Your account price may differ; use a request quote where supported.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

run_id
string
required
taskgroup_id
string
required

Response

Successful Response

Status of a task run.

created_at
string | null
required

Timestamp of the creation of the task, as an RFC 3339 string.

Example:

"2025-04-24T18:56:22.513132Z"

interaction_id
string
required

Identifier for this interaction. Pass this value as previous_interaction_id to reuse context for a future request.

Example:

"trun_e0083b6aac0544eb8686e8d2a76533d2"

is_active
boolean
required

Whether the run is currently active, i.e. status is one of {'cancelling', 'queued', 'running'}.

modified_at
string | null
required

Timestamp of the last modification to the task, as an RFC 3339 string.

Example:

"2025-04-24T18:56:22.513132Z"

processor
string
required

Processor used for the run.

Example:

"base"

run_id
string
required

ID of the task run.

Example:

"trun_e0083b6aac0544eb8686e8d2a76533d2"

status
enum<string>
required

Status of the run.

Available options:
queued,
action_required,
running,
completed,
failed,
cancelling,
cancelled
Examples:

"queued"

"action_required"

"running"

"completed"

"failed"

"cancelling"

"cancelled"

error
Error · object | null

Error for the run, present only if status is 'failed'.

metadata
Metadata · object | null

User-provided metadata stored with the run.

Example:
taskgroup_id
string | null

ID of the taskgroup to which the run belongs.

warnings
Warning · object[] | null

Warnings for the run, if any.

Example: