# Get agent job (/api/agent/v2/get-agent-job)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 963 · updated: 2026-07-30 -->
Related: [Create agent job](/api/agent/v2/create-agent-job.md), [Send follow-up message](/api/agent/v2/send-message.md)

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.

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

Retrieves the current status and details of an agent job. Poll this endpoint to track job progress.

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "projectId",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
    },
    {
      "name": "id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string"
      },
      "description": "The unique identifier of the agent job."
    }
  ],
  "responses": {
    "200": {
      "description": "Agent job details",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "Unique identifier for the agent job."
              },
              "status": {
                "type": "string",
                "enum": [
                  "active",
                  "completed",
                  "archived",
                  "failed"
                ],
                "description": "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`."
              },
              "source": {
                "type": "object",
                "description": "Source repository information.",
                "properties": {
                  "repository": {
                    "type": "string",
                    "description": "Full URL of the GitHub repository."
                  },
                  "ref": {
                    "type": "string",
                    "description": "Git branch the agent is working on.",
                    "nullable": true
                  }
                }
              },
              "model": {
                "type": "string",
                "description": "The AI model used for this job."
              },
              "prLink": {
                "type": "string",
                "format": "uri",
                "example": "https://github.com/org/repo/pull/123",
                "description": "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.",
                "nullable": true
              },
              "createdAt": {
                "type": "string",
                "format": "date-time",
                "description": "Timestamp when the job was created."
              },
              "archivedAt": {
                "type": "string",
                "format": "date-time",
                "description": "Timestamp when the job was archived.",
                "nullable": true
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "Job not found",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message."
              }
            }
          }
        }
      }
    }
  }
}
```