> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener tarea del agente

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

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.


## OpenAPI

````yaml es/admin-openapi.json GET /v2/agent/{projectId}/job/{id}
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}:
    get:
      summary: Obtener trabajo del agente
      description: >-
        Recupera el estado actual y los detalles de un trabajo del agente.
        Consulta este endpoint para seguir el progreso del trabajo.
      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:
                $ref: '#/components/schemas/AgentJob'
        '404':
          description: Trabajo no encontrado
          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.

````

## Related topics

- [Crear tarea de agente](/es/api/agent/v2/create-agent-job.md)
- [Enviar un mensaje de seguimiento](/es/api/agent/v2/send-message.md)
- [Obtener comentarios](/es/api/analytics/feedback.md)