> For the complete documentation index, see [llms.txt](https://docs.avastudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avastudio.com/api-and-mcp/tools/ask-ava.md).

# Ask Ava

Talk to Studio’s campaign copilot. Each message uses credits; she starts nothing else that spends them.

### ava\_ask

One turn with Ava, the campaign copilot of Studio's Ask Ava (shared with Studio): her reply plus her actions, for 40 credits per message plus the AI usage. Via the API she starts nothing that spends credits: she reads, discusses, approves and edits drafts (with this key's campaigns scopes); plans, drafting, production, research and settings come back failed, naming the tool to use (plan\_run, concepts\_draft\_more, creative\_produce, research\_\*, campaign\_update). Returns a job\_id; poll jobs\_get.

* **Permission:** Ask Ava (`agent`)
* **Price:** 40 credits per message + tokens
* **Runs as a job:** yes. It returns a `job_id`; follow it with `jobs_get`, whose `result` is the output.
* **REST:** `POST /v1/ava_ask`

#### Input

| Field             | Type   | Required | Description                                                                                                                 |
| ----------------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `campaign_id`     | string | Yes      | Campaign id from campaign\_list or campaign\_create.                                                                        |
| `message`         | string | Yes      | What to ask or tell Ava, in the user's words. If she asked the user something, send their own answer. 1 to 4000 characters. |
| `idempotency_key` | string |          | Reuse the same key when retrying; the call runs and charges once. 8 to 128 characters.                                      |
