Skip to main content
Agent clients should inspect state before mutating it. Recommended loop:
  1. Run firstsales whoami --json.
  2. Read the target organization and workspace.
  3. Fetch the resource state.
  4. Plan the smallest mutation.
  5. Use --dry-run when available.
  6. Use --idempotency-key for retryable writes.
  7. Use --confirm only for intentional destructive commands.
  8. Re-read the resource and verify the result.

​
Example

firstsales campaigns get --org org_123 --workspace ws_123 --campaign camp_123 --json
firstsales campaigns pause --org org_123 --workspace ws_123 --campaign camp_123 --json
firstsales campaigns get --org org_123 --workspace ws_123 --campaign camp_123 --json

​
Never use private routes

If a command or endpoint returns unsupported_operation, do not search for app-private alternatives. The operation is intentionally not part of the public contract.