ReferenceUntagged
List Deep Research events
List persisted progress for a Deep Research run in chronological order. Pass the returned cursor unchanged to receive only newer events. The cursor remains usable when no new events are available.
GET/api/v1/ee/projects/{projectUuid}/ai-deep-research/{aiDeepResearchRunUuid}/events
Authentication: personal access token. The spec defines an api_key security
scheme — send an Authorization: ApiKey <your-personal-access-token> header
(value format: ApiKey <your key>). A session_cookie scheme (connect.sid)
exists for browser sessions. Operations in this spec declare security: [], an
artifact of the upstream spec generator — authentication is still enforced by the
server.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectUuid | string | Yes | |
aiDeepResearchRunUuid | string | Yes |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
cursor | string | No | |
limit | number | No |
Responses
200 — Success
{
"results": {
"nextCursor": "string",
"events": [
{
"createdAt": "string",
"payload": {
"status": "queued"
},
"eventType": "status_changed",
"aiDeepResearchRunUuid": "string",
"aiDeepResearchEventUuid": "string"
}
]
},
"status": "ok"
}default — Error
{
"error": {
"data": "string",
"message": "string",
"name": "string",
"statusCode": 0
},
"status": "error"
}