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

# Crear contexto de implementación

> Reúne contexto técnico con fuentes citadas dentro de un presupuesto de tokens para una aplicación o agente.



## OpenAPI

````yaml es/index-openapi.json POST /v1/context
openapi: 3.0.1
info:
  title: API de Mintlify Index
  description: >-
    Busca y recupera documentación técnica y contexto web para aplicaciones y
    agentes.
  version: 1.0.0
servers:
  - url: https://leaves.mintlify.com/api/universal-search
security:
  - bearerAuth: []
paths:
  /v1/context:
    post:
      summary: Crear contexto de implementación
      description: >-
        Busca en Mintlify Index y devuelve contenido con fuentes citadas reunido
        dentro de un presupuesto de tokens. Usa este endpoint cuando una
        aplicación o agente necesite contexto listo para usar en una sola
        solicitud.
      operationId: buildIndexContext
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContextRequest'
            example:
              query: ¿Cómo debo configurar el almacenamiento en caché en Next.js 16?
              product: Next.js
              format: txt
              tokenBudget: 3000
      responses:
        '200':
          description: El contexto se creó correctamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextResponse'
              example:
                requestId: 7f2ab8d1-3bea-4a29-bc51-c05a8d3a3e3c
                query: >-
                  ¿Cómo debo configurar el almacenamiento en caché en Next.js
                  16?
                response: >-
                  ### Almacenamiento en caché y revalidación


                  Fuente:
                  https://nextjs.org/docs/app/getting-started/caching-and-revalidating


                  Usa las API de almacenamiento en caché actuales descritas en
                  esta guía.


                  --------------------------------
                resultsCount: 3
                outputTokens: 1842
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  schemas:
    ContextRequest:
      type: object
      additionalProperties: false
      required:
        - query
        - format
      properties:
        query:
          type: string
          minLength: 1
          description: Pregunta de implementación que se investigará.
        product:
          type: string
          minLength: 1
          description: >-
            Nombre del producto o empresa que se usará como indicio adicional de
            recuperación.
        format:
          type: string
          enum:
            - txt
            - json
          description: >-
            Formato de la cadena `response`. `txt` devuelve secciones Markdown.
            `json` devuelve un objeto JSON serializado que contiene elementos de
            resultados.
        includeDomains:
          type: array
          minItems: 1
          items:
            type: string
            minLength: 1
          description: Dominios que se incluirán en la recuperación.
        excludeDomains:
          type: array
          minItems: 1
          items:
            type: string
            minLength: 1
          description: Dominios que se excluirán de la recuperación.
        tokenBudget:
          type: integer
          minimum: 1
          maximum: 6000
          default: 3000
          description: Número máximo de tokens de salida.
    ContextResponse:
      type: object
      additionalProperties: false
      required:
        - requestId
        - query
        - response
        - resultsCount
        - outputTokens
      properties:
        requestId:
          type: string
          description: Identificador único de la solicitud.
        query:
          type: string
          description: Consulta original de la solicitud.
        response:
          type: string
          description: >-
            Contenido de fuentes reunido. El valor es Markdown para solicitudes
            `txt` y JSON serializado para solicitudes `json`. La cadena puede
            estar vacía cuando ningún contenido cabe en el presupuesto de
            tokens.
        resultsCount:
          type: integer
          minimum: 0
          description: Número de fragmentos de fuentes incluidos en la respuesta.
        outputTokens:
          type: integer
          minimum: 0
          description: Número de tokens de la respuesta reunida.
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: string
          description: Mensaje de error.
  responses:
    BadRequest:
      description: El cuerpo de la solicitud no es válido.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Cuerpo de solicitud no válido
    Unauthorized:
      description: >-
        Falta la clave de API, no es válida o la organización no tiene acceso a
        la API REST de Index.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: No autorizado
    Forbidden:
      description: La IP de la solicitud no está permitida por la clave de API.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: La dirección IP no está permitida para esta clave de API
    RateLimited:
      description: La organización superó un límite de uso.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Límite de uso superado. Vuelve a intentarlo más tarde
    InternalError:
      description: Index no pudo completar la solicitud.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clave de API de Mintlify Index
      description: Clave de API de Mintlify Index con el prefijo `mint_us_`.

````

## Related topics

- [Implementaciones de vista previa](/docs/es/deploy/preview-deployments.md)
- [Vista general de automatizaciones](/docs/es/automations/index.md)
- [Descripción general](/docs/es/components/index.md)
