GRGlobalRouter Docs
Console

Task / GET

Stream task events

Subscribes to SSE events for one async task.

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
POST/v1/tasksCreates a unified async task.
GET/v1/tasks/{task_id}Queries async task status and artifacts.
GET/v1/tasks/{task_id}/eventsSubscribes to SSE events for one async task.
GET/v1/tasks/{task_id}/events

Used to listen for task status changes in the frontend or backend. Mobile shows only the endpoint list; use desktop for event fields.

Back to Task endpoint list

Request parameters

FieldTypeRequiredDescription
task_idpathYesTask ID.

Response fields

FieldTypeRequiredDescription
eventstringNoSSE event name.
data.statusstringYesTask status.
data.progressnumberNoTask progress.

Errors

401UNAUTHORIZED

Missing or invalid Authorization Bearer token.

403FORBIDDEN

The current API key is not allowed to call this scope or model.

429RATE_LIMITED

请求过快或异步任务队列已满，请降低并发或稍后重试。