---
title: Check usage limits for each client
description: Read workspace quotas and each client's prompt, AI, and cadence
  entitlement summary, then decide how to handle shortages.
canonical_url: https://orchestor.io/docs/en/cli/workflows/agency-capacity
markdown_url: https://orchestor.io/docs/en/cli/workflows/agency-capacity.md
contentType: how-to
---

# 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.

```bash
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 --json
```

## 1. 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.

[All workflows](https://orchestor.io/docs/en/cli/workflows.md)

If a failure remains, [report it and verify the fix](https://orchestor.io/docs/cli/workflows/workflow-feedback.md), including this workflow and the failed step.

---

[Documentation index](https://orchestor.io/docs/llms.txt)