Start

Agents

App store purchases

Auth

Builds

Credits

Database

Flags

Generated Assets

Hosting

Jobs and cron

Knowledge

Localization

Monitoring

Network

Notifications

Organizations

Queues

Realtime

Runners

Sandboxes

Storage

Webhooks

Workflows

Getting Started

Installation

Authentication

AI Services

KV Store

Overview

Webhooks

Deploy & Infrastructure

Reference

On this page

get
list
create
update
delete
qualify
observe

Reference

sylphx agents owner_pools

Every sylphx agents owner_pools command: its argument, its flags and a run line.

Checked 2026-09-28

The owner_pools commands of Sylphx Agents, as the CLI spells them: the same calls as the owner_pools API page, typed for the shell. Install, sign in and the grammar 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

Shell

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

#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

Shell

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

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

Shell

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

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

Shell

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

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

Shell

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

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

Shell

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

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

Shell

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

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.

Was this page helpful?

Tell us what is missing, wrong, or unclear — this opens a real inbox.

Send feedback

Platform links