# Prompts

Las preguntas que lanzamos a los modelos de IA cada semana y los registros de ejecución que genera cada ejecución.

### GET `/dimensions/prompts`

Lista los prompts de un proyecto.

**Parámetros:**

- `project_id` obligatorio
- `collection_id`
- `prompt` ID de prompt
- `country_code`
- `language_code`
- `from`
- `to`
- `page`
- `per_page` ≤ 100

### GET `/dimensions/prompt_executions`

Lista las ejecuciones de prompt de un proyecto.

**Parámetros:**

- `project_id` obligatorio
- `model`
- `collection_id`
- `prompt` ID de prompt
- `country_code`
- `language_code`
- `from`
- `to`
- `page`
- `per_page`
- `mention_filter`
- `citation_filter`
- `competitors` la matriz de dos ejes descrita en `GET /answers`

### GET `/dimensions/query_fan_outs`

Las subconsultas que un modelo emitió realmente al responder a tus prompts monitorizados, útiles para descubrir la redacción que los modelos buscan en lugar de la redacción que escribiste tú. `view=query` (por defecto) devuelve una fila por subconsulta distinta con su recuento y su proporción sobre el total de apariciones; `view=prompt` devuelve una fila por prompt con el número de subconsultas distintas que generó. El fan-out lo reporta principalmente ChatGPT, así que un resultado vacío suele significar que los modelos consultados no lo exponen.

**Parámetros:**

- `project_id` obligatorio
- `view` `query` o `prompt`
- `query` subcadena del texto de la subconsulta
- `order`
- `direction`
- `model`
- `collection_id`
- `prompt`
- `country_code`
- `language_code`
- `prompt_type`
- `brand_kind`
- `range`
- `from`
- `to`
- `page`
- `per_page`
- `output`

### POST `/prompts`

Crea hasta 100 prompts por solicitud. Los prompts existentes (mismo texto + locale) se omiten.

**Cuerpo (JSON):**

- `project_id` obligatorio
- `prompts` array, obligatorio, máx. 100
- `country_code` obligatorio
- `language_code` obligatorio

### DELETE `/prompts/:id`

Elimina un prompt. Es irreversible; el prompt desaparece de inmediato, libera un hueco de prompt y un trabajo en segundo plano purga su historial (ejecuciones, menciones, citaciones, sentimiento). Requiere una clave de API con permisos de escritura.

**Parámetros:**

- `project_id` obligatorio
- `:id` en la URL

Devuelve `ERR_NOT_FOUND` para prompts fuera del proyecto.

Acceso completo. Cancela cuando quieras.