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

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

## get

Gets an owner pool with its members.

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

**CLI**

```bash
sylphx agents owner-pools get orgs/acme/projects/shop/envs/production/owner_pools/owner-pool
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/owner_pools/owner-pool` · scope `agents:read` · effect `read` · [Request, response and examples](/docs/api/owner_pools/get)

## list

Lists owner pools, newest first.

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

**CLI**

```bash
sylphx agents owner-pools list orgs/acme/projects/shop/envs/production
```

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

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--page-size` | `int` | At most this many; default 50, clamped to 1000. |
| `--page-token` | `string` | `next_page_token` of the previous page. |

## create

Creates an owner pool with no members. Its minimums and demotion rules are governance, so the caller needs `agents:admin`.

**`ID`** — The id segment of the new Resource's name; the server assigns one when omitted.

**CLI**

```bash
sylphx agents owner-pools create --parent orgs/acme/projects/shop/envs/production --spec.admission.suite … --spec.admission.suite-version …
```

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

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--parent` | `string` | The parent to create in; defaults to the linked project or the key's scope. |
| `--meta.labels` | `key=value` | Caller-writable, indexed labels (AIP-122 label rules). Repeat the flag for each value. |
| `--meta.annotations` | `key=value` | Caller-writable, unindexed annotations. Repeat the flag for each value. |
| `--meta.display-name` | `string` | Caller-writable human-readable name. |
| `--spec.admission.suite` | `string` | The suite's id, matched exactly by `:qualify`; at most 200 characters. Required. |
| `--spec.admission.min-scores` | `key=value` | Minimum score per suite metric, higher is better; 1 to 64 metrics. A member qualifies only when every metric is reported at or above its minimum. Required. Repeat the flag for each value. |
| `--spec.admission.suite-version` | `string` | The suite's version, matched exactly by `:qualify`; at most 200 characters. Required. |
| `--spec.demotion` | `json` | Live-metric rules that demote a member; at most 16, each metric once. Repeat the flag for each value. |

## update

Replaces an owner pool's spec (`agents:admin`). Members keep their standing; a changed suite or minimum applies from the next `:qualify`.

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

**CLI**

```bash
sylphx agents owner-pools update orgs/acme/projects/shop/envs/production/owner_pools/owner-pool --spec.admission.suite … --spec.admission.suite-version …
```

`PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/owner_pools/owner-pool` · scope `agents:admin` · effect `write` · [Request, response and examples](/docs/api/owner_pools/update)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--meta.labels` | `key=value` | Caller-writable, indexed labels (AIP-122 label rules). Repeat the flag for each value. |
| `--meta.annotations` | `key=value` | Caller-writable, unindexed annotations. Repeat the flag for each value. |
| `--meta.display-name` | `string` | Caller-writable human-readable name. |
| `--spec.admission.suite` | `string` | The suite's id, matched exactly by `:qualify`; at most 200 characters. Required. |
| `--spec.admission.min-scores` | `key=value` | Minimum score per suite metric, higher is better; 1 to 64 metrics. A member qualifies only when every metric is reported at or above its minimum. Required. Repeat the flag for each value. |
| `--spec.admission.suite-version` | `string` | The suite's version, matched exactly by `:qualify`; at most 200 characters. Required. |
| `--spec.demotion` | `json` | Live-metric rules that demote a member; at most 16, each metric once. Repeat the flag for each value. |

## delete

Deletes an owner pool and its members (`agents:admin`). Sessions already admitted keep running.

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

**CLI**

```bash
sylphx agents owner-pools delete orgs/acme/projects/shop/envs/production/owner_pools/owner-pool --yes
```

`DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/owner_pools/owner-pool` · scope `agents:admin` · effect `destructive` · [Request, response and examples](/docs/api/owner_pools/delete)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--yes` | `bool` | Do not ask before this destructive call. |

## qualify

Records an admission suite result for an Agent version. The caller holds `agents:qualify` and is not the principal whose create or update minted the version (`PERMISSION_DENIED`). Every minimum met: the member is `QUALIFIED`. Any score missing or below its minimum: the member is recorded `REFUSED` with the reason. Each qualification is recorded with its suite, suite version, result and caller; a `result` already recorded for the member is refused with `INVALID_FIELD`, so a demoted member returns only with a new suite result. A read-only version is refused with `PERMISSION_DENIED`; a suite or suite version other than the pool's with `INVALID_FIELD`. Re-qualifying keeps the member's baseline: the baseline belongs to the version and its pinned model.

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

**CLI**

```bash
sylphx agents owner-pools qualify orgs/acme/projects/shop/envs/production/owner_pools/owner-pool
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/owner_pools/owner-pool:qualify` · scope `agents:qualify` · effect `write` · [Request, response and examples](/docs/api/owner_pools/qualify)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--agent-version` | `string` | The Agent version that ran the suite, in the pool's environment. Required. |
| `--suite` | `string` | The suite that ran; must equal the pool's `admission.suite`. Required. |
| `--scores` | `key=value` | The score per suite metric; at most 64. Required. Repeat the flag for each value. |
| `--suite-version` | `string` | The suite version that ran; must equal the pool's `admission.suite_version`. Required. |
| `--result` | `string` | The grader's id of this suite run, for example its evidence record; 1 to 200 characters. Each result is recorded once per member. Required. |

## observe

Records a live-metric observation for a member and applies the pool's demotion rules (`agents:qualify`, refused to the version's authors as in `:qualify`). The platform computes each rule's baseline: the median of the member's first `baseline_observations` counted observations of the metric, set only when it is finite and positive. Values of a rule metric are lower-is-better and must not be negative. Once the baseline is set, a metric past `baseline * (1 + max_regression)` demotes a qualified member. Only `:qualify` brings a demoted member back.

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

**CLI**

```bash
sylphx agents owner-pools observe orgs/acme/projects/shop/envs/production/owner_pools/owner-pool
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/owner_pools/owner-pool:observe` · scope `agents:qualify` · effect `write` · [Request, response and examples](/docs/api/owner_pools/observe)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--agent-version` | `string` | The member version. Required. |
| `--metrics` | `key=value` | The observed value per metric over the caller's window, lower is better; 1 to 64. A demotion rule's metric is never negative. Required. Repeat the flag for each value. |
| `--samples` | `int` | The number of outcomes the values summarize. Required. |