# Créer une tâche d'agent (/fr/api/agent/v2/create-agent-job)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1353 · updated: 2026-07-30 -->

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 [#limites-dutilisation]
</div>

* 100 utilisations par projet Mintlify et par heure

<div id="usage">
  ## Utilisation [#utilisation]
</div>

```bash
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"}'
```

`POST /v2/agent/{projectId}/job`

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.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "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": {
            "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
              }
            }
          }
        }
      }
    },
    "400": {
      "description": "requête invalide",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    },
    "429": {
      "description": "limite de débit dépassé",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    }
  }
}
```