> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.another-horizon.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener tarea de agente por ID

> Obtiene los detalles y el estado de una tarea de agente específica por su ID.

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

Este endpoint obtiene los detalles y el estado de un trabajo de agente específico mediante su identificador único. Úsalo para comprobar el progreso, el estado y los resultados de un trabajo de agente creado previamente.

<div id="job-details">
  ## Detalles del trabajo
</div>

La respuesta incluye información como:

* Estado de ejecución del trabajo y estado de finalización
* Información de la branch y detalles de la solicitud de extracción
* metadata de la sesión y marcas de tiempo


## OpenAPI

````yaml es/admin-openapi.json get /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: 1.0.0
servers:
  - url: https://api.mintlify.com/v1
security:
  - bearerAuth: []
paths:
  /agent/{projectId}/job/{id}:
    get:
      summary: Obtener tarea de agente por ID
      description: >-
        Obtiene los detalles y el estado de una tarea de agente específica por
        su ID.
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: >-
            El ID de tu proyecto. Puedes copiarlo en 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 de agente que se debe recuperar.
      responses:
        '200':
          description: Los detalles de la tarea del agente se han recuperado correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  sessionId:
                    type: string
                    description: El subdomain al que corresponde esta sesión.
                  subdomain:
                    type: string
                    description: El subdominio al que pertenece esta sesión.
                  branch:
                    type: string
                    description: >-
                      Nombre de la branch de Git en la que se realizaron los
                      cambios.
                    nullable: true
                  haulted:
                    type: boolean
                    description: Indica si se interrumpió la ejecución de la sesión.
                  haultReason:
                    type: string
                    enum:
                      - completed
                      - github_missconfigured
                      - error
                    description: Motivo de la interrupción de la sesión.
                  pullRequestLink:
                    type: string
                    description: Enlace a la solicitud de extracción creada.
                  messageToUser:
                    type: string
                    description: Mensaje para el usuario acerca del resultado de la sesión.
                  todos:
                    type: array
                    description: Lista de tareas pendientes de la sesión.
                    items:
                      type: object
                      properties:
                        content:
                          type: string
                          description: Descripción breve de la tarea.
                        status:
                          type: string
                          enum:
                            - pending
                            - in_progress
                            - completed
                            - cancelled
                          description: Estado actual de la tarea.
                        priority:
                          type: string
                          enum:
                            - high
                            - medium
                            - low
                          description: Prioridad de la tarea.
                        id:
                          type: string
                          description: Identificador único de la tarea pendiente.
                  createdAt:
                    type: string
                    format: date-time
                    description: Marca de tiempo de creación de la sesión.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        El encabezado Authorization requiere un token Bearer. Crea una [Admin
        API Key](https://dashboard.mintlify.com/settings/organization/api-keys)
        aquí.

````