> ## Documentation Index
> Fetch the complete documentation index at: https://developer.firstsales.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Safe Agent Workflows

> How Codex, Claude Code, Gemini, and other agents should operate FirstSales.

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

```bash theme={null}
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.