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

# Crear un informe de propuesta

> Genera un informe del espacio de propuestas a partir de una URL pública. Requiere una clave global de organización, acceso al espacio de propuestas y una asignación disponible. Devuelve un ID duradero mientras se investiga. Consulta GET /api/v1/pitches/{pitch_id} hasta que pitch.status sea completed o failed. Cualquiera que tenga la URL puede acceder al informe. Cada solicitud admitida consume una propuesta, incluso si falla la generación. Reintentar con la misma organización, Idempotency-Key y entrada normalizada reutiliza la propuesta; otra entrada devuelve 409. Usa una clave nueva para pedir expresamente una instantánea nueva. La generación no envía correo.



## OpenAPI

````yaml es/api-reference/openapi.json post /api/v1/pitches
openapi: 3.1.0
info:
  title: API de AthenaHQ
  description: >-
    La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web
    y consultas para optimizar el contenido con IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Servidor de producción
security:
  - apiKey: []
tags:
  - name: Basics
    description: Operaciones principales de la API para gestionar sitios web y consultas
  - name: Metrics
    description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA
  - name: Billing
    description: Endpoints de facturación y créditos para gestionar el uso
  - name: Team Management
    description: Endpoints para gestionar miembros del equipo e invitaciones
  - name: Groups
    description: Endpoints para gestionar grupos de sitios web
  - name: Content
    description: >-
      Endpoints para acceder a los datos del centro de contenidos: pestañas, URL
      monitorizadas y desglose de consultas por URL.
  - name: Pitch Workspace
    description: >-
      Endpoints para acceder a los informes del espacio de propuestas:
      ejecuciones de propuestas con alcance de organización, con competidores,
      consultas, atributos y métricas agregadas.
  - name: Knowledge Base
    description: >-
      Endpoints para leer la base de conocimientos de la marca: datos aprobados
      sobre la marca y los pilares que los organizan.
paths:
  /api/v1/pitches:
    post:
      tags:
        - Pitch Workspace
      summary: Crear un informe de propuesta
      description: >-
        Genera un informe del espacio de propuestas a partir de una URL pública.
        Requiere una clave global de organización, acceso al espacio de
        propuestas y una asignación disponible. Devuelve un ID duradero mientras
        se investiga. Consulta GET /api/v1/pitches/{pitch_id} hasta que
        pitch.status sea completed o failed. Cualquiera que tenga la URL puede
        acceder al informe. Cada solicitud admitida consume una propuesta,
        incluso si falla la generación. Reintentar con la misma organización,
        Idempotency-Key y entrada normalizada reutiliza la propuesta; otra
        entrada devuelve 409. Usa una clave nueva para pedir expresamente una
        instantánea nueva. La generación no envía correo.
      operationId: createPitch
      parameters:
        - name: Idempotency-Key
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 128
          description: >-
            Identificador estable de una solicitud lógica. Consérvalo en los
            reintentos.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - website_url
              properties:
                website_url:
                  type: string
                  maxLength: 2000
                  example: https://example.com
                country:
                  type: string
                  maxLength: 100
                  default: United States
                language:
                  type: string
                  maxLength: 100
                  default: English
      responses:
        '202':
          description: >-
            Aceptada, o el resultado existente de un reintento idempotente. La
            generación puede tardar varios minutos.
          content:
            application/json:
              schema:
                type: object
                required:
                  - pitch_id
                  - status
                  - report_url
                properties:
                  pitch_id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - processing
                      - completed
                      - failed
                  report_url:
                    type: string
                    format: uri
        '400':
          description: Cuerpo o URL no válidos, o falta Idempotency-Key.
        '401':
          description: Falta la clave de API o no es válida.
        '403':
          description: >-
            Se requiere una clave global de organización, acceso al espacio de
            propuestas o una asignación de propuestas.
        '404':
          description: Se ha eliminado el informe de esta solicitud.
        '409':
          description: Idempotency-Key ya se ha utilizado con otros datos de entrada.
        '429':
          description: >-
            Se ha superado el límite de solicitudes o de tres informes
            simultáneos. Respeta Retry-After.
        '500':
          description: >-
            No se ha podido confirmar la admisión. Reintenta pronto con la misma
            Idempotency-Key; contacta con soporte si no se resuelve.
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clave de API para autenticarse. Puedes crear una
        [aquí](https://app.athenahq.ai/organization?tab=api).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.