# Get agent job

GET

/

v2

/

agent

/

/

job

/

Get agent job

```
curl --request GET \
  --url https://api.mintlify.com/v2/agent/{projectId}/job/{id} \
  --header 'Authorization: Bearer <token>'
```

:::code-group
```title="200"
{
  "id": "<string>",
  "status": "active",
  "source": {
    "repository": "<string>",
    "ref": "<string>"
  },
  "model": "<string>",
  "prLink": "https://github.com/org/repo/pull/123",
  "createdAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z"
}
```

```title="404"
{
  "error": "<string>"
}
```
:::

Poll this endpoint to track the progress of an agent job. The `status` field transitions through `active` → `completed` or `failed`. After the agent creates a pull request, the `prLink` field contains the link.

#### Authorizations

Authorization

string

header

required

The Authorization header expects a Bearer token. Use an admin API key. This is a server-side secret key. Generate one on the [API keys page](https://app.mintlify.com/settings/organization/api-keys) in your dashboard.

#### Path Parameters

projectId

string

required

Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard.

id

string

required

The unique identifier of the agent job.

#### Response

Agent job details

id

string

Unique identifier for the agent job.

status

enum\<string>

Current status of the job. `active` — the agent is currently processing the prompt. `completed` — the agent finished successfully and a PR may have been created (check `prLink`). `archived` — the job has been archived. `failed` — the agent encountered an unrecoverable error. Poll until status is `completed`, `archived`, or `failed`.

Available options:

`active`,

`completed`,

`archived`,

`failed`

source

object

Source repository information.

:::accordion{title="Show child attributes"}
:::

model

string

The AI model used for this job.

prLink

string\<uri> | null

GitHub pull request URL created by the agent. `null` while the job is still `active` or if no files were changed. Populated once the agent successfully creates a PR.

Example:

`"https://github.com/org/repo/pull/123"`

createdAt

string\<date-time>

Timestamp when the job was created.

archivedAt

string\<date-time> | null

Timestamp when the job was archived.

⌘I

## Related pages

- [Admin](./admin-index.md)
- [Agent](./agent-2-index.md)
- [Agent](./agent-index.md)
- [Agent-ready content](./agent-ready-content-index.md)
- [AI](./ai-index.md)
- [Analytics](./analytics-index.md)
- [API docs](./api-docs-index.md)
- [API reference](./api-reference-index.md)
- [Assistant](./assistant-2-index.md)
- [Assistant](./assistant-index.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.