# Envoyer un message de suivi (/fr/api/agent/v2/send-message)

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

Envoyez une instruction de suivi à une tâche d’agent existante. Le message est traité de façon asynchrone — interrogez le point de terminaison [récupérer la tâche d’agent](/fr/api/agent/v2/get-agent-job) pour suivre sa progression.

<div id="rate-limits">
  ## Limites de débit [#limites-de-débit]
</div>

* 100 utilisations par projet Mintlify par heure

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

```bash
curl -X POST https://api.mintlify.com/v2/agent/{projectId}/job/{id}/message \
  -H "Authorization: Bearer mint_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Also add error handling examples to the quickstart guide"}'
```

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

Envoie un message de suivi à une tâche d’agent existante. Le message est traité de manière asynchrone — interroger le point de terminaison get job pour suivre la progression.

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 à laquelle envoyer un message."
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "prompt"
          ],
          "properties": {
            "prompt": {
              "type": "string",
              "minLength": 1,
              "description": "L’instruction de suivi destinée à l’agent."
            }
          }
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Message envoyé 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."
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "Tâche introuvable",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    },
    "429": {
      "description": "Limite de débit dépassée",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Message d’erreur."
              }
            }
          }
        }
      }
    }
  }
}
```