Python
from parallel import Parallel
client = Parallel()
events = client.task_run.events(run_id="run_id")
for event in events:
print(event)import Parallel from "parallel-web";
const client = new Parallel();
const events = await client.taskRun.events(
'run_id',
);
for await (const event of events) {
console.log(event);
}
HttpResponse<String> response = Unirest.get("https://api.parallel.ai/v1/tasks/runs/{run_id}/events")
.header("x-api-key", "<api-key>")
.asString();curl --request GET \
--url https://api.parallel.ai/v1/tasks/runs/{run_id}/events \
--header 'x-api-key: <api-key>'{
"type": "task_run.progress_msg.plan",
"message": "Planning task...",
"timestamp": "2025-04-23T20:21:48.037943Z"
}{
"type": "error",
"error": {
"ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
"message": "Unauthorized: invalid or missing credentials"
}
}{
"type": "error",
"error": {
"ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
"message": "Run id not found"
}
}{
"type": "error",
"error": {
"ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
"message": "Request validation error"
}
}Tasks
Stream Task Run Events
Streams events for a task run.
Returns a stream of events showing progress updates and state changes for the task run.
For task runs that did not have enable_events set to true during creation, the frequency of events will be reduced.
GET
/
v1
/
tasks
/
runs
/
{run_id}
/
events
Python
from parallel import Parallel
client = Parallel()
events = client.task_run.events(run_id="run_id")
for event in events:
print(event)import Parallel from "parallel-web";
const client = new Parallel();
const events = await client.taskRun.events(
'run_id',
);
for await (const event of events) {
console.log(event);
}
HttpResponse<String> response = Unirest.get("https://api.parallel.ai/v1/tasks/runs/{run_id}/events")
.header("x-api-key", "<api-key>")
.asString();curl --request GET \
--url https://api.parallel.ai/v1/tasks/runs/{run_id}/events \
--header 'x-api-key: <api-key>'{
"type": "task_run.progress_msg.plan",
"message": "Planning task...",
"timestamp": "2025-04-23T20:21:48.037943Z"
}{
"type": "error",
"error": {
"ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
"message": "Unauthorized: invalid or missing credentials"
}
}{
"type": "error",
"error": {
"ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
"message": "Run id not found"
}
}{
"type": "error",
"error": {
"ref_id": "fcb2b4f3-c75e-4186-87bc-caa1a8381331",
"message": "Request validation error"
}
}Authorizations
Path Parameters
Response
Successful Response
- TaskRunProgressStatsEvent
- TaskRunProgressMessageEvent
- TaskRunEvent
- ErrorEvent
A progress update for a task run.
Event type; always 'task_run.progress_stats'.
Allowed value:
"task_run.progress_stats"Source stats describing progress so far.
Show child attributes
Show child attributes
Completion percentage of the task run. Ranges from 0 to 100 where 0 indicates no progress and 100 indicates completion.