Glasser
GET/v1/runs/:runId

Get run status and output

Returns the current state of one run. When the status is COMPLETED, provider_response is not null: a 2xx body is in output (any JSON shape, null for an empty body), and a non-2xx body is in provider_response.error. When the status is FAILED, failure is not null. Status does not imply that money moved: charge_usd and charge_basis are reported independently, and a FAILED run with a non-zero charge is a normal outcome, not a contradiction.

Request

bash
curl -X GET https://api.glasser.ai/v1/runs/:runId \
  -H "Authorization: Bearer gl_..."

Path parameters

runIdstringrequired

Response

200
idstringrequired
providerstringrequired
endpointstringrequired
endpoint_versionintegerrequired
statusenumrequired
QUEUEDRUNNINGCOMPLETEDFAILEDSTOPPED
failureobjectrequired
kindenumrequired
TIMED_OUTINTERNAL
messagestringrequired
inputobjectrequired
outputunknownrequired
provider_responseobjectrequired
http_statusintegerrequired
errorunknownoptional
charge_usdstringrequired

Exact USD decimal string (min 2, max 6 decimals, one canonical spelling). Sum with decimal arithmetic or scale by 10^6 — never floats.

charge_basisobjectrequired
clauseenumrequired
ruleNO_RESULTPROVIDER_ERRORTIMED_OUTINTERNAL
quantityintegerrequired
stoppablebooleanrequired
stop_requested_atstring (ISO-8601)required

ISO-8601 UTC timestamp

created_atstring (ISO-8601)required

ISO-8601 UTC timestamp

started_atstring (ISO-8601)required

ISO-8601 UTC timestamp

completed_atstring (ISO-8601)required

ISO-8601 UTC timestamp

Errors

400validation_failedThe request does not satisfy the schema. details.issues lists the fields that failed, and details.location names the part of the request that carried them: Payload, Headers, Path, or Query.
401unauthorizedThe API key is missing, malformed, revoked, or unknown.
404not_foundThe resource does not exist, it does not belong to the workspace that the credentials are bound to, or the policy does not permit reading it.
429rate_limitedThe rate limit is exceeded. error.retry_after_ms tells you how long to wait.
500internal_errorThe server failed. The response body does not include internal details.

Authentication

Requires Bearer authentication. The workspace is bound to the API key, and you cannot change it with a request header.

Authorization: Bearer gl_...

Base URL: https://api.glasser.ai