# copilot

> AI Copilot: runs (WCP/1 SSE), previews, confirmations, approvals tray, limits.

AI Copilot: runs (WCP/1 SSE), previews, confirmations, approvals tray, limits.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/copilot/actions` | `copilot_actions_list`: Approvals tray (incl. MCP/API/companion-originated) | `copilot:use` | - |
| GET | `/v1/copilot/actions/{action_id}` | `copilot_actions_get`: Preview-card data (+ an approval token for the caller) | `copilot:use` | - |
| POST | `/v1/copilot/actions/{action_id}/confirm` | `copilot_actions_confirm`: Confirm an action (step 2 of spend/double = on-screen tap) | `copilot:use` | - |
| POST | `/v1/copilot/actions/{action_id}/reject` | `copilot_actions_reject`: Reject an action | `copilot:use` | - |
| POST | `/v1/copilot/actions/{action_id}/undo` | `copilot_actions_undo`: Undo a reversible action (new action with undo_of) | `copilot:use` | - |
| GET | `/v1/copilot/briefing` | `copilot_briefing_get`: Today's briefing as a Briefing card | `copilot:use` | - |
| GET | `/v1/copilot/limits` | `copilot_limits_get`: Effective spend/send limits | `copilot:use` | - |
| PUT | `/v1/copilot/limits` | `copilot_limits_set`: Set per-role spend limits (owner only; raising needs step-up) | `org:write` | - |
| GET | `/v1/copilot/mcp-connections` | `copilot_mcp_connections_list`: MCP clients connected to this org | `copilot:use` | - |
| DELETE | `/v1/copilot/mcp-connections/{grant_id}` | `copilot_mcp_connections_revoke`: Revoke an MCP connection | `copilot:use` | - |
| GET | `/v1/copilot/mcp-connections/{grant_id}` | `copilot_mcp_connections_get`: One MCP connection | `copilot:use` | - |
| GET | `/v1/copilot/memory` | `copilot_memory_list`: Copilot memory items | `copilot:use` | - |
| DELETE | `/v1/copilot/memory/{item_id}` | `copilot_memory_delete`: Forget a memory item | `copilot:use` | - |
| GET | `/v1/copilot/memory/{item_id}` | `copilot_memory_get`: One memory item | `copilot:use` | - |
| POST | `/v1/copilot/runs/{run_id}/cancel` | `copilot_runs_cancel`: Stop text generation (never an executing action) | `copilot:use` | - |
| GET | `/v1/copilot/runs/{run_id}/events` | `copilot_run_events_list`: Replay / resume WCP/1 events after seq | `copilot:use` | - |
| GET | `/v1/copilot/settings` | `copilot_settings_get`: Copilot mode and preferences | `copilot:use` | - |
| PATCH | `/v1/copilot/settings` | `copilot_settings_update`: Change Copilot mode (careful / balanced) - owner only | `org:write` | - |
| GET | `/v1/copilot/speech` | `copilot_speech_get`: Which voice services are available | `copilot:use` | - |
| GET | `/v1/copilot/stt` | `copilot_stt_connect`: Streaming speech-to-text (WebSocket upgrade) | `copilot:use` | - |
| GET | `/v1/copilot/suggestions` | `copilot_suggestions_list`: Next best actions for Home | `copilot:use` | - |
| GET | `/v1/copilot/threads` | `copilot_threads_list`: List my Copilot threads | `copilot:use` | - |
| POST | `/v1/copilot/threads` | `copilot_threads_create`: New Copilot thread | `copilot:use` | - |
| DELETE | `/v1/copilot/threads/{thread_id}` | `copilot_threads_delete`: Delete a thread | `copilot:use` | - |
| GET | `/v1/copilot/threads/{thread_id}` | `copilot_threads_get`: Thread with messages and open actions | `copilot:use` | - |
| PATCH | `/v1/copilot/threads/{thread_id}` | `copilot_threads_update`: Rename, pin or archive a thread | `copilot:use` | - |
| GET | `/v1/copilot/threads/{thread_id}/messages` | `copilot_messages_list`: Thread history | `copilot:use` | - |
| POST | `/v1/copilot/threads/{thread_id}/runs` | `copilot_runs_create`: Submit input; streams WCP/1 events (SSE) | `copilot:use` | - |
| GET | `/v1/copilot/tools` | `copilot_tools_list`: Tools visible to the caller (locked ones explain the plan) | `copilot:use` | - |
| POST | `/v1/copilot/transcripts` | `copilot_transcripts_create`: Sign words heard on the device for review before sending | `copilot:use` | - |
| POST | `/v1/copilot/transcripts/audio` | `copilot_audio_transcripts_create`: Turn a short recording into words for review before sending | `copilot:use` | - |
| POST | `/v1/copilot/tts` | `copilot_tts_create`: Sentence TTS for read-aloud | `copilot:use` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
