---
title: "Get agent job by ID (v1)"
method: GET
path: "/v1/agent/{projectId}/job/{id}"
deprecated: true
---

# Get agent job by ID (v1)

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

> **Deprecated.**

Deprecated: use [v2 get agent job](/api/agent/v2/get-agent-job) instead. Retrieves the details and status of a specific agent job by its ID.

Authenticate with an admin API key.

## Path parameters

- `projectId` string, required
- `id` string, required

## Response `200`

Agent job details retrieved successfully

- object
  - `sessionId` string — The subdomain this session belongs to.
  - `subdomain` string — The subdomain this session belongs to.
  - `branch` string, nullable — Git branch name where changes were made.
  - `haulted` boolean — Whether the session execution was halted.
  - `haultReason` 'completed' | 'github_missconfigured' | 'error' | 'processing' | 'interrupted' — Reason for session halt. `processing` indicates the job is still running. `interrupted` indicates the job was manually interrupted.
  - `pullRequestLink` string — Link to the created pull request.
  - `messageToUser` string — Message for the user about the session outcome.
  - `todos` object[] — List of todo items from the session.
    - `content` string — Brief description of the task.
    - `status` 'pending' | 'in_progress' | 'completed' | 'cancelled' — Current status of the task.
    - `priority` 'high' | 'medium' | 'low' — Priority level of the task.
    - `id` string — Unique identifier for the todo item.
  - `userId` string — The ID of the user who created this session, if available.
  - `title` string — A generated title summarizing the agent job.
  - `createdAt` string, date-time — Timestamp when the session was created.

---

[API](https://skmtc.dev/mcp-b/apis/mintlify-admin-api.md) · [All operations](https://skmtc.dev/mcp-b/apis/mintlify-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mcp-b/mintlify-admin-api/revisions/6165028f8792/schema)