# Récupérer une tâche d’agent (/fr/api/agent/v2/get-agent-job)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1021 · updated: 2026-07-30 -->

Interrogez régulièrement ce point de terminaison pour suivre la progression d’une tâche d’agent. Le champ `status` passe de `active` à `completed` ou `failed`.

Une fois que l’agent a créé une pull request (demande de fusion), le champ `prLink` est renseigné.

`GET /v2/agent/{projectId}/job/{id}`

Récupère le statut actuel et les détails d’une tâche d’agent. Interrogez ce point de terminaison pour suivre la progression de la tâche.

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."
    },
    {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "L’identifiant unique de la tâche d’agent."
    }
  ],
  "responses": {
    "200": {
      "description": "Détails de la tâche d’agent",
      "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
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "Tâche introuvable",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    }
  }
}
```