Check usage limits for each client
When to use this workflow
“Review capacity for each client and handle shortages or spare capacity.”
Before fetching
Confirm the workspace purpose, prompt count, AI selection, cadence, and available capacity for each client. Orchestor capacity is fixed per workspace and cannot move between clients.
Read the organization's workspace quota and each workspace's entitlement summary, then decide how to handle shortages.
Prerequisites
Use an authenticated account with permission to read client workspaces. This workflow is read-only.
Quick reference
Replace the placeholders with the organization and client workspace IDs.
orc workspaces quotas get --workspace YOUR_AGENCY_WORKSPACE_ID --json
orc workspaces list --include-management true --workspace YOUR_AGENCY_WORKSPACE_ID --json
orc prompts list --workspace YOUR_CLIENT_A_ID --json
orc prompts list --workspace YOUR_CLIENT_B_ID --json1. Read the organization's workspace quota
workspaces quotas get returns brand_workspaces, client_workspaces, pitch_workspaces, and active_pitch_workspaces. Read limit, used, remaining, unlimited, and reset_at for each entry.
2. Read each client's entitlement summary
workspaces list --include-management true returns management for each workspace. Compare purpose, lifecycle_status, activePromptCount, promptLimit, modelSelection, and cadence for each client.
3. Handle shortages or spare capacity
For client workspaces, check client_workspaces. For pitch workspaces, check both pitch_workspaces and active_pitch_workspaces. Contact your organization administrator if you need additional capacity. The CLI does not purchase capacity or transfer it between clients.
If a workspace has spare prompt capacity, add or replace prompts within that workspace. This does not transfer client A's capacity to client B. Run prompts list before changing the selected workspace.
If the operation stops
This workflow does not change state. If it stops, run the same read commands again to retrieve the latest quota and entitlement summaries.
If a failure remains, report it and verify the fix, including this workflow and the failed step.