> ## 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 trabajo de agente (v1)

> En desuso: usa [v2 get agent job](/api/agent/v2/get-agent-job) en su lugar. Recupera los detalles y el estado de un trabajo del agente específico a partir de su ID.

<Warning>Este endpoint está en desuso. Usa en su lugar el endpoint [v2 obtener trabajo de agente](/es/api/agent/v2/get-agent-job).</Warning>

<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 /v1/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:
  /v1/agent/{projectId}/job/{id}:
    get:
      summary: Obtener trabajo del agente por ID (v1)
      description: >-
        En desuso: usa [v2 get agent job](/api/agent/v2/get-agent-job) en su
        lugar. Recupera los detalles y el estado de un trabajo del agente
        específico a partir de su ID.
      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 que se va a recuperar.
      responses:
        '200':
          description: Detalles del trabajo del agente recuperados correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  sessionId:
                    type: string
                    description: El subdomain al que pertenece esta sesión.
                  subdomain:
                    type: string
                    description: El subdomain 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 detuvo la ejecución de la sesión.
                  haultReason:
                    type: string
                    enum:
                      - completed
                      - github_missconfigured
                      - error
                      - processing
                      - interrupted
                    description: >-
                      Motivo de la interrupción de la sesión. `processing`
                      indica que la tarea está en curso. `interrupted` indica
                      que la tarea fue interrumpida manualmente.
                  pullRequestLink:
                    type: string
                    description: Enlace a la solicitud de extracción creada.
                  messageToUser:
                    type: string
                    description: Mensaje para el usuario sobre el 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: Breve descripción 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: Nivel de prioridad de la tarea.
                        id:
                          type: string
                          description: Identificador único de la tarea pendiente.
                  userId:
                    type: string
                    description: >-
                      El ID del usuario que creó esta sesión, si está
                      disponible.
                  title:
                    type: string
                    description: Título generado que resume el trabajo del agente.
                  createdAt:
                    type: string
                    format: date-time
                    description: Marca de tiempo de creación de la sesión.
      deprecated: true
components:
  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

- [skill.md](/docs/es/ai/skillmd.md)
- [Comentarios](/docs/es/optimize/feedback.md)
- [Vista general de automatizaciones](/docs/es/automations/index.md)
