Command reference
deployments org
Organizations and tenancy
| Command | Summary |
|---|---|
deployments org list | List organizations |
deployments org show | Show an organization |
deployments org create | Create an organization |
deployments org update | Update an organization |
deployments org limits | Show the request rate, concurrent run, and sandbox limits the organization runs under |
deployments org standing | Show whether the organization is suspended, why, and the limits and model spend ceiling it runs under |
deployments org spend | Show a month's spend split into operator-funded and organization-funded, with the operator-funded ceiling |
deployments org project-spend | Show a month's spend for each project, split into operator-funded and organization-funded |
deployments org list
List organizations.
deployments org list- Calls
GET /v1/organizations(SDKlistOrganizations). - No tenancy context required.
- Paginated.
--page-sizesets the page size; pass the returned cursor as--cursorfor the next page.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--cursor | string (cursor) | Pagination cursor | ||
--page-size | string (number) | Page size |
Also accepts the global flags.
deployments org show
Show an organization.
deployments org show <id>- Calls
GET /v1/organizations/{id}(SDKgetOrganization). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments org create
Create an organization.
deployments org create --name <name>- Calls
POST /v1/organizations(SDKcreateOrganization). - No tenancy context required.
- Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
--name | string | yes | Resource name | |
--slug | string | URL-safe organization slug |
Also accepts the global flags.
deployments org update
Update an organization.
deployments org update <id>- Calls
PATCH /v1/organizations/{id}(SDKupdateOrganization). - Needs an organization:
--orgor the saved context. - Sends an idempotency key. The CLI generates one per run; pass
--idempotency-keyto retry safely.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--name | string | New organization name | ||
--slug | string | New organization slug |
Also accepts the global flags.
deployments org limits
Show the request rate, concurrent run, and sandbox limits the organization runs under.
deployments org limits <id>- Calls
GET /v1/organizations/{id}/limits(SDKgetOrganizationLimits). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments org standing
Show whether the organization is suspended, why, and the limits and model spend ceiling it runs under.
deployments org standing <id>- Calls
GET /v1/organizations/{id}/standing(SDKgetOrganizationStanding). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID |
Also accepts the global flags.
deployments org spend
Show a month's spend split into operator-funded and organization-funded, with the operator-funded ceiling.
deployments org spend <id>- Calls
GET /v1/organizations/{id}/spend(SDKgetOrganizationSpend). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--month | string | UTC month as YYYY-MM; defaults to the current month |
Also accepts the global flags.
deployments org project-spend
Show a month's spend for each project, split into operator-funded and organization-funded.
deployments org project-spend <id>- Calls
GET /v1/organizations/{id}/spend/projects(SDKgetOrganizationProjectSpend). - Needs an organization:
--orgor the saved context.
| Flag | Type | Required | Default | Description |
|---|---|---|---|---|
<id> | positional | yes | Resource ID | |
--month | string | UTC month as YYYY-MM; defaults to the current month |
Also accepts the global flags.