# Obtener tarea del agente (/es/api/agent/v2/get-agent-job)

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

Consulta periódicamente este endpoint para hacer seguimiento del progreso de una tarea del agente. El campo `status` pasa de `active` a `completed` o `failed`.

Una vez que el agente crea una solicitud de extracción, el campo `prLink` se completa.

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

Recupera el estado actual y los detalles de un trabajo del agente. Consulta este endpoint para seguir el progreso del trabajo.

Autentícate con una clave de API de administrador.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "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) en tu dashboard."
    },
    {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "El identificador único del trabajo del agente."
    }
  ],
  "responses": {
    "200": {
      "description": "Detalles del trabajo del agente",
      "content": {
        "application/json": {
          "schema": {
            "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
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "Trabajo no encontrado",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Mensaje de error."
              }
            }
          }
        }
      }
    }
  }
}
```