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

# Créer une tâche d'agent

> Crée une nouvelle tâche d’agent qui s’exécute en arrière-plan. La tâche traite le prompt de manière asynchrone — interrogez le point de terminaison get job pour suivre sa progression. Si l’agent modifie les fichiers avec succès, une pull request (demande de fusion) est automatiquement créée.

Authentifiez-vous avec une clé d'API administrateur.

Ce point de terminaison crée une tâche d'agent en arrière-plan. La tâche s'exécute de manière asynchrone. Utilisez le point de terminaison [récupérer une tâche d'agent](/fr/api/agent/v2/get-agent-job) pour vérifier régulièrement les mises à jour de statut.

Si l'agent modifie les fichiers avec succès, Mintlify crée une pull request (demande de fusion) et renseigne le champ `prLink` dans la réponse de la tâche.

<div id="rate-limits">
  ## Limites d’utilisation
</div>

* 100 utilisations par projet Mintlify et par heure

<div id="usage">
  ## Utilisation
</div>

```bash theme={null}
curl -X POST https://api.mintlify.com/v2/agent/{projectId}/job \
  -H "Authorization: Bearer mint_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Add a quickstart guide for the Python SDK"}'
```


## OpenAPI

````yaml fr/admin-openapi.json POST /v2/agent/{projectId}/job
openapi: 3.0.1
info:
  title: Mintlify Admin API
  description: >-
    Une API pour les opérations administratives, y compris les mises à jour de
    la documentation et la gestion des agents.
  version: 2.0.0
servers:
  - url: https://api.mintlify.com
security:
  - bearerAuth: []
paths:
  /v2/agent/{projectId}/job:
    post:
      summary: Créer une tâche d’agent
      description: >-
        Crée une nouvelle tâche d’agent qui s’exécute en arrière-plan. La tâche
        traite le prompt de manière asynchrone — interrogez le point de
        terminaison get job pour suivre sa progression. Si l’agent modifie les
        fichiers avec succès, une pull request (demande de fusion) est
        automatiquement créée.


        Authentifiez-vous avec une clé d'API administrateur.
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            L’ID de votre projet. Vous pouvez le copier depuis la page [API
            keys](https://dashboard.mintlify.com/settings/organization/api-keys)
            de votre Dashboard.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                prompt:
                  type: string
                  minLength: 1
                  description: L’instruction que l’agent doit exécuter.
      responses:
        '201':
          description: Tâche d’agent créée avec succès
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentJob'
        '400':
          description: requête invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: limite de débit dépassé
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AgentJob:
      type: object
      properties:
        id:
          type: string
          description: Identifiant unique de la tâche d’agent.
        status:
          type: string
          enum:
            - active
            - completed
            - archived
            - failed
          description: >-
            Statut actuel de la tâche. `active` — l’agent traite actuellement le
            prompt. `completed` — l’agent a terminé avec succès et une PR a
            peut-être été créée (vérifiez `prLink`). `archived` — la tâche a été
            archivée. `failed` — l’agent a rencontré une erreur non récupérable.
            Interrogez régulièrement jusqu’à ce que le statut soit `completed`,
            `archived` ou `failed`.
        source:
          type: object
          description: Informations sur le référentiel source.
          properties:
            repository:
              type: string
              description: URL complète du référentiel GitHub.
            ref:
              type: string
              description: Branche Git sur laquelle l’agent travaille.
              nullable: true
        model:
          type: string
          description: Modèle d’IA utilisé pour cette tâche.
        prLink:
          type: string
          format: uri
          example: https://github.com/org/repo/pull/123
          description: >-
            URL de la pull request (demande de fusion) GitHub créée par l’agent.
            `null` tant que la tâche est `active` ou si aucun fichier n’a été
            modifié. Renseignée une fois que l’agent a créé une PR avec succès.
          nullable: true
        createdAt:
          type: string
          format: date-time
          description: Horodatage de création de la tâche.
        archivedAt:
          type: string
          format: date-time
          description: Horodatage d’archivage de la tâche.
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: string
          description: Message d’erreur.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        L'en-tête Authorization requiert un jeton Bearer. Utilisez une clé d'API
        administrateur. Il s'agit d'une clé secrète côté serveur. Générez-en une
        depuis la [page des clés
        d'API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        votre Dashboard.

````