---
title: "add_ai_prompt"
method: POST
path: "/api/v1/add_ai_prompt"
---

# add_ai_prompt

`POST /api/v1/add_ai_prompt`

## Request

- Base URL: `https://app.miraqo.io`
- URL: `https://app.miraqo.io/api/v1/add_ai_prompt`
- Auth: HTTP bearer

Crea un prompt di Presenza AI e avvia il primo check. I crediti consumati dipendono dalle sources (pesi correnti nel campo credit_weights di get_ai_visibility) sulla quota crediti Presenza AI del piano. AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui.

## Request body

- object
  - `project_id` integer, required
  - `query` string, required
  - `sources` string[], required
  - `intent_category` 'informational' | 'comparative' | 'commercial' | 'problem_solving'
  - `location_code` integer: override di mercato del prompt (codice paese, es. 2724 = Spagna); default: il mercato del progetto. La stessa query può essere monitorata su più mercati.
  - `language_code` string: lingua del mercato override (es. "es"); default: la principale del paese

## Response `200`

ok=true, risultato in data

## Other responses

- `400`: ok=false, messaggio in error

---

[API](https://skmtc.dev/miraqo/apis/miraqo-api.md) · [All operations](https://skmtc.dev/miraqo/apis/miraqo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/miraqo/apis/miraqo-api/revisions/dae27ff4da65?raw)