bird organization workspaces rate-limits

Usage

bird organization workspaces rate-limits

Description

Only for organizations with several workspaces. A workspace limit sits under the shared organization limit and reserves no capacity. Read attribution.status first: ready can be set now, warming after attribution.ready_at, unavailable never by waiting, so do not retry. Removing a limit always works.

Reads return JSON. Mutations take flags and/or a --body-file JSON body (flags overriding); run --example to print the body shape or --dry-run to preview the request. Destructive commands require --yes.

Procedure

Set a workspace rate limit

Read the workspace's policies with an organization credential, then set a workspace limit only on a policy whose attribution is ready.

Requires: Workspace limits are managed from the organization with org:workspaces write, and only matter with several workspaces. Target the workspace by its ID; a workspace credential cannot set its own workspace limit. With one live workspace only an unexpired existing limit can be changed; anything else is refused with E03085.

1. bird organization workspaces rate-limits list — Set a workspace limit only where attribution.status is ready. When it is warming, wait until attribution.ready_at; when it is unavailable it cannot be set in this region by waiting, so do not retry. Skip the update when workspace_limit already holds the requested value and expiry.
2. bird organization workspaces rate-limits update — The value replaces the whole workspace limit. Send expires_at again to keep an existing expiry; omitting it removes the expiry.

Commands