---
# @generated by sylphx-gen. Do not edit.
title: "Queued executions"
description: "The `queued_executions` collection of Sylphx Agents: Explicit caller authority reserved for one exact future Session turn."
type: reference
product: agents
summary: "Explicit caller authority reserved for one exact future Session turn."
updated: 2026-09-28
order: 900
---

Explicit caller authority reserved for one exact future Session turn. It reuses captured credentials; it never mints, clones or extends a grant.

**Service** Sylphx Agents · **Resource type** `agents.sylphx.com/QueuedSessionExecution` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/agent_sessions/{agent_session}/queued_executions/{turn}` · **Shape** `record`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | Exact Session and reserved public turn number. |
| `uid` | `string` | Immutable platform Resource UID. Output only. |
| `meta` | `ResourceMeta` | Standard metadata. Output only. |
| `turn` | `int64` | Exact future turn; never selected by a model or a Task. Output only. |
| `state` | `string` | queued, consumed, superseded or cancelled. Queued does not run inference. Output only. |
| `goal` | `string` | Optional exact Goal whose objective and budget this authority covers. Output only. |
| `expire_time` | `timestamp` | Earliest captured handle expiry; ordinary admission revalidates all grants. Output only. |
| `create_time` | `timestamp` | When the caller reserved this execution. Output only. |
| `update_time` | `timestamp` | When the state last changed. Output only. |
| `generation` | `int64` | Configuration generation, advanced only by explicit replacement. Output only. |
| `automatic` | `bool` | Whether the caller explicitly authorized automatic wait readmission. Output only. |
| `continuation_state` | `string` | disabled, unscheduled, pending, waiting or finished; no inference implied. Output only. |
| `blocked_reason` | `string` | Current delivery/authority/owner hold, when automatic continuation is blocked. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/queued_executions#get) | Reads the state of an exact future-turn authorization. |
| `POST` | [`cancel`](/docs/api/queued_executions#cancel) | Cancels only a queued future execution; an already admitted turn retains its receipt. |

## get

Reads the state of an exact future-turn authorization.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/queued_executions/turn` · scope `agents:sessions` · effect `read` · [Request, response and examples](/docs/api/queued_executions/get)

## cancel

Cancels only a queued future execution; an already admitted turn retains its receipt.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/queued_executions/turn:cancel` · scope `agents:sessions` · effect `write` · [Request, response and examples](/docs/api/queued_executions/cancel)