> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.manicule.dev/es/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://mintlify.manicule.dev/es/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://mintlify.manicule.dev/api/mcp.
> Every agent surface: https://mintlify.manicule.dev/.well-known/llms-manifest.json

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

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1155 · updated: 2026-07-31 -->

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.

Base URL: `https://api.mintlify.com`

## OpenAPI

```json
{
  "servers": [
    {
      "url": "https://api.mintlify.com"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "securitySchemes": {
    "bearerAuth": {
      "type": "http",
      "scheme": "bearer",
      "description": "El encabezado Authorization requiere un token de tipo Bearer. Usa una clave de API de administrador. Esta es una clave secreta del lado del servidor. Genera una en la [página de claves de API](https://dashboard.mintlify.com/settings/organization/api-keys) de tu dashboard."
    }
  },
  "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."
              }
            }
          }
        }
      }
    }
  }
}
```