---
# @generated by sylphx-gen. Do not edit.
title: "sylphx agents waits"
description: "The sylphx agents waits commands of Sylphx Agents: every verb, with its argument, its flags and a run line."
type: reference
product: agents
summary: "Every sylphx agents waits command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

The `waits` commands of Sylphx Agents, as the CLI spells them: the same
calls as [the `waits` API page](/docs/api/waits), typed for the
shell. [Install, sign in and the grammar](/docs/cli) are on the CLI index.

## create

Creates a durable wait on an idle Session, with permanent operation replay.

**CLI**

```bash
sylphx agents waits create --parent orgs/acme/projects/shop/envs/production/agent_sessions/agent-session --type … --resume-prompt …
```

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

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--parent` | `string` | The parent to create in; defaults to the linked project or the key's scope. |
| `--goal` | `string` | Optional exact Goal in this Session, never a current-Goal selector. |
| `--type` | `string` | time or signal. Other producer types require their own admitted adapter. Required. |
| `--reference` | `string` | Exact source reference for a signal; empty for a timer. |
| `--deadline` | `timestamp` | Actual future due time; required only for a timer. |
| `--resume-prompt` | `string` | What to do after observing this wait's evidence, at most 16 KiB. Required. |
| `--operation-id` | `string` | Permanent caller mutation identity, at most 128 bytes. Required. |
| `--expected-goal-version` | `int` | Required when the wait names a Goal; its exact observed contract version. |

## get

Reads an exact wait and its retained evidence.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents waits get orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits/wait
```

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

## list

Lists durable waits, including ready undelivered owners.

**`PARENT`** — optional: the CLI fills it from the linked project or the
key's scope when it is left out.

**CLI**

```bash
sylphx agents waits list orgs/acme/projects/shop/envs/production/agent_sessions/agent-session
```

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

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--page-size` | `int` | Default 50, clamped to 1000. |
| `--page-token` | `string` | The preceding response's next_page_token. |

## resolve

Records observed signal evidence or checks a timer against its actual due time.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents waits resolve orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits/wait
```

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

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--operation-id` | `string` | Permanent caller mutation identity, at most 128 bytes. Required. |
| `--reference` | `string` | Exact recorded signal source; omitted for a timer. |
| `--evidence` | `json` | Nonempty observed signal evidence; omitted for a timer. |

## cancel

Cancels only this exact undelivered wait; repeated operations retain receipts.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx agents waits cancel orgs/acme/projects/shop/envs/production/agent_sessions/agent-session/waits/wait
```

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

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--operation-id` | `string` | Permanent caller mutation identity, at most 128 bytes. Required. |