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

# Enviar un mensaje de seguimiento

> Envía un mensaje de seguimiento a un trabajo del agente existente. El mensaje se procesa de forma asíncrona: consulta periódicamente el endpoint get job para seguir el progreso.

Envía una instrucción de seguimiento a una tarea de agente existente. El mensaje se procesa de forma asíncrona; consulta el endpoint [obtener la tarea de agente](/es/api/agent/v2/get-agent-job) para seguir su progreso.

<div id="rate-limits">
  ## Límites de uso
</div>

* 100 usos por proyecto de Mintlify por hora

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

```bash theme={null}
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"}'
```


## OpenAPI

````yaml es/admin-openapi.json POST /v2/agent/{projectId}/job/{id}/message
openapi: 3.0.1
info:
  title: Mintlify Admin API
  description: >-
    Una API de operaciones administrativas, incluidas las actualizaciones de
    documentación y la gestión de agentes.
  version: 2.0.0
servers:
  - url: https://api.mintlify.com
security:
  - bearerAuth: []
paths:
  /v2/agent/{projectId}/job/{id}/message:
    post:
      summary: Enviar mensaje de seguimiento
      description: >-
        Envía un mensaje de seguimiento a un trabajo del agente existente. El
        mensaje se procesa de forma asíncrona: consulta periódicamente el
        endpoint get job para seguir el progreso.
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            El ID de tu proyecto. Puedes copiarlo desde la página de [API
            keys](https://dashboard.mintlify.com/settings/organization/api-keys)
            de tu dashboard.
        - name: id
          in: path
          required: true
          schema:
            type: string
          description: >-
            El identificador único del trabajo del agente al que se enviará un
            mensaje.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - prompt
              properties:
                prompt:
                  type: string
                  minLength: 1
                  description: La instrucción de seguimiento para el agente.
      responses:
        '200':
          description: Mensaje enviado correctamente
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentJob'
        '400':
          description: Solicitud no válida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Trabajo no encontrado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Se superó el límite de solicitudes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    AgentJob:
      type: object
      properties:
        id:
          type: string
          description: Identificador único del trabajo del agente.
        status:
          type: string
          enum:
            - active
            - completed
            - archived
            - failed
          description: >-
            Estado actual del trabajo. `active` — el agente está procesando la
            instrucción en este momento. `completed` — el agente finalizó
            correctamente y es posible que se haya creado una PR (verificar
            `prLink`). `archived` — el trabajo se ha archivado. `failed` — el
            agente encontró un error irrecuperable. Consulte periódicamente
            hasta que el estado sea `completed`, `archived` o `failed`.
        source:
          type: object
          description: Información del repositorio de origen.
          properties:
            repository:
              type: string
              description: URL completa del repositorio de GitHub.
            ref:
              type: string
              description: branch de Git en la que trabaja el agente.
              nullable: true
        model:
          type: string
          description: El modelo de IA utilizado para esta tarea.
        prLink:
          type: string
          format: uri
          example: https://github.com/org/repo/pull/123
          description: >-
            URL de la solicitud de extracción de GitHub creada por el agente.
            `null` mientras la tarea siga `active` o si no se ha cambiado ningún
            archivo. Se completa cuando el agente crea correctamente una PR.
          nullable: true
        createdAt:
          type: string
          format: date-time
          description: Marca de tiempo de creación de la tarea.
        archivedAt:
          type: string
          format: date-time
          description: Marca de tiempo de archivado de la tarea.
          nullable: true
    Error:
      type: object
      properties:
        error:
          type: string
          description: Mensaje de error.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        El encabezado Authorization requiere un token de tipo Bearer. Usa una
        clave de API de administrador (con el prefijo `mint_`). Esta es una
        clave secreta del lado del servidor. Genera una clave en la [página de
        claves de
        API](https://dashboard.mintlify.com/settings/organization/api-keys) de
        tu dashboard.

````