Skip to content
Console
Menu

Alerts and status pages

App store purchases

Credits

Knowledge

KV

Notifications

Organizations

Storage

Workflows

API reference

Getting Started

Authentication

KV Store

Get a queued execution

Reads the state of an exact future-turn authorization.

Reads the state of an exact future-turn authorization.

  • Path GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/queued_executions/turn
  • Scope agents:sessions
  • Effect read — nothing is written.
  • Collection queued_executions

#Request

FieldTypeWhat it is
namestringExact reserved execution name. Required.

#Response

FieldTypeWhat it is
namestringExact Session and reserved public turn number.
uidstringImmutable platform Resource UID. Output only.
metaResourceMetaStandard metadata. Output only.
turnint64Exact future turn; never selected by a model or a Task. Output only.
statestringqueued, consumed, superseded or cancelled. Queued does not run inference. Output only.
goalstringOptional exact Goal whose objective and budget this authority covers. Output only.
expire_timetimestampEarliest captured handle expiry; ordinary admission revalidates all grants. Output only.
create_timetimestampWhen the caller reserved this execution. Output only.
update_timetimestampWhen the state last changed. Output only.
generationint64Configuration generation, advanced only by explicit replacement. Output only.
automaticboolWhether the caller explicitly authorized automatic wait readmission. Output only.
continuation_statestringdisabled, unscheduled, pending, waiting or finished; no inference implied. Output only.
blocked_reasonstringCurrent delivery/authority/owner hold, when automatic continuation is blocked. Output only.

#ResourceMeta

FieldTypeWhat it is
generationint64Increases by one on every change to spec. Output only.
etagstringStrong ETag (AIP-154): changes on any change to spec, status, or metadata. Send it back as If-Match or etag to make Update and Delete conditional; a mismatch fails with ABORTED / 409 ETAG_MISMATCH. Output only.
create_timetimestampWhen the Resource was created. Output only.
update_timetimestampWhen the Resource last changed. Output only.
delete_timetimestampSet while the Resource is being deleted. Output only.
labelsmap<string, string>Caller-writable, indexed labels (AIP-122 label rules).
annotationsmap<string, string>Caller-writable, unindexed annotations.
display_namestringCaller-writable human-readable name.
creatorstringThe principal that created the Resource. Output only.

#Errors

Every error arrives in the body Errors describes.

#Examples

curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/queued_executions/turn" \
  -H "Authorization: Bearer $SYLPHX_API_KEY"