> ## 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.

# Construire le contexte d’implémentation

> Assemblez un contexte technique accompagné de ses sources dans une limite de jetons pour une application ou un agent.



## OpenAPI

````yaml fr/index-openapi.json POST /v1/context
openapi: 3.0.1
info:
  title: API Mintlify Index
  description: >-
    Recherchez et récupérez de la documentation technique et du contexte web
    pour vos applications et agents.
  version: 1.0.0
servers:
  - url: https://leaves.mintlify.com/api/universal-search
security:
  - bearerAuth: []
paths:
  /v1/context:
    post:
      summary: Construire le contexte d’implémentation
      description: >-
        Recherche dans Mintlify Index et renvoie du contenu accompagné de ses
        sources, assemblé dans une limite de jetons. Utilisez ce point de
        terminaison lorsqu’une application ou un agent a besoin d’un contexte
        prêt à l’emploi en une seule requête.
      operationId: buildIndexContext
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContextRequest'
            example:
              query: "Comment dois-je configurer la mise en cache dans Next.js 16\_?"
              product: Next.js
              format: txt
              tokenBudget: 3000
      responses:
        '200':
          description: Contexte assemblé avec succès.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContextResponse'
              example:
                requestId: 7f2ab8d1-3bea-4a29-bc51-c05a8d3a3e3c
                query: "Comment dois-je configurer la mise en cache dans Next.js 16\_?"
                response: >-
                  ### Mise en cache et revalidation


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


                  Utilisez les API de mise en cache actuelles décrites dans ce
                  guide.


                  --------------------------------
                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: Question d’implémentation à étudier.
        product:
          type: string
          minLength: 1
          description: >-
            Nom du produit ou de l’entreprise à utiliser comme indication de
            récupération supplémentaire.
        format:
          type: string
          enum:
            - txt
            - json
          description: >-
            Format de la chaîne `response`. `txt` renvoie des sections Markdown.
            `json` renvoie un objet JSON sérialisé contenant les éléments de
            résultat.
        includeDomains:
          type: array
          minItems: 1
          items:
            type: string
            minLength: 1
          description: Domaines à inclure dans la récupération.
        excludeDomains:
          type: array
          minItems: 1
          items:
            type: string
            minLength: 1
          description: Domaines à exclure de la récupération.
        tokenBudget:
          type: integer
          minimum: 1
          maximum: 6000
          default: 3000
          description: Nombre maximal de jetons en sortie.
    ContextResponse:
      type: object
      additionalProperties: false
      required:
        - requestId
        - query
        - response
        - resultsCount
        - outputTokens
      properties:
        requestId:
          type: string
          description: Identifiant unique de la requête.
        query:
          type: string
          description: Requête d’origine.
        response:
          type: string
          description: >-
            Contenu source assemblé. La valeur est au format Markdown pour les
            requêtes `txt` et au format JSON sérialisé pour les requêtes `json`.
            La chaîne peut être vide lorsqu’aucun contenu ne tient dans la
            limite de jetons.
        resultsCount:
          type: integer
          minimum: 0
          description: Nombre d’extraits de sources inclus dans la réponse.
        outputTokens:
          type: integer
          minimum: 0
          description: Nombre de jetons dans la réponse assemblée.
    Error:
      type: object
      additionalProperties: false
      required:
        - error
      properties:
        error:
          type: string
          description: Message d’erreur.
  responses:
    BadRequest:
      description: Le corps de la requête n’est pas valide.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Corps de requête invalide
    Unauthorized:
      description: >-
        La clé d’API est absente ou invalide, ou l’organisation n’a pas accès à
        l’API REST Index.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Non autorisé
    Forbidden:
      description: L’adresse IP de la requête n’est pas autorisée par la clé d’API.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: L’adresse IP n’est pas autorisée pour cette clé d’API
    RateLimited:
      description: L’organisation a dépassé une limite de débit.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: Limite de débit dépassée. Veuillez réessayer plus tard
    InternalError:
      description: Index n’a pas pu terminer la requête.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clé d’API Mintlify Index
      description: Clé d’API Mintlify Index avec le préfixe `mint_us_`.

````

## Related topics

- [Vue d'ensemble des automatisations](/docs/fr/automations/index.md)
- [Référence des commandes de la CLI Mintlify](/docs/fr/cli/commands.md)
- [Assistant](/docs/fr/assistant/index.md)