GamebeastDocs
Dashboard

Read saved query execution state

POST
/application/{applicationId}/analytics/v1/queries/{queryId}/executions/state

Return the current state of a saved query's execution without starting one. Used to recover after a remount or a dropped websocket, so a client never has to re-POST (and duplicate work) just to learn an outcome. Takes the same override body as execute so it can resolve the same variant. POST is used only to carry that body.

Authorization

AuthorizationBearer <token>

Secret server key (prefixed gb_sk_) for server-to-server calls. Send it as Authorization: Bearer <key>. Never ship a secret key in a game client.

In: header

Path Parameters

applicationId*number

Gamebeast project ID

queryId*number

Header Parameters

environment_id*number

Gamebeast environment ID

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/application/0/analytics/v1/queries/0/executions/state" \  -H "environment_id: 0" \  -H "Content-Type: application/json" \  -d '{}'
{  "status": "ready",  "executionId": "string",  "data": null,  "refreshedAt": "string",  "executionMs": 0,  "startedAt": "string",  "progress": {    "readRows": 0,    "totalRowsApprox": 0,    "elapsedMs": 0,    "sampledAt": "string"  },  "error": {    "code": "string",    "message": "string"  },  "dedupJoiners": 0,  "variantToken": "string"}