Glasser
GET/v1/runs

List runs

Lists runs in reverse order of creation time, with optional filters on status, provider, and endpoint. This endpoint uses cursor pagination. The list is scoped by the effective policy: runs of an endpoint this key cannot run are not readable either.

Request

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

Query parameters

limitstringoptional
cursorstringoptional
statusenumoptional
QUEUEDRUNNINGCOMPLETEDFAILEDSTOPPED
providerstringoptional
endpointstringoptional

Response

200
dataobject[]required
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

next_cursorstringrequired

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.
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