---
title: "Read Assistant job status and results"
method: POST
path: "/api/v2/agent/getJob"
tags: ["Agent"]
---

# Read Assistant job status and results

`POST /api/v2/agent/getJob`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/agent/getJob`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Read a queued, running, or terminal Assistant job and its customer-visible messages. Service tokens can read jobs within their organization; user credentials retain authorship and current repository access requirements. Internal tool results and diagnostic context are omitted. resultSummary is brief; complete scoped reports are persisted as ASSISTANT messages. Poll this operation with the jobId returned by agent.triggerCronSchedule.

## Request body

- AgentGetJobRequest
  - `organizationId` string
  - `jobId` string, uuid, required

## Response `200`

Success

- AgentGetJobResponse
  - `job` object, required
    - `id` string, uuid, required
    - `organizationId` string, required
    - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
    - `trigger` 'MANUAL' | 'CRON' | 'SLACK' | 'EVENT', required
    - `prompt` string, required
    - `trusted` boolean, required
    - `contextType` 'SLACK_THREAD' | 'SLACK_CHANNEL' | 'EVENT_PAYLOAD' | 'MANUAL' | 'CRON', nullable, required
    - `startedAt` string, date-time, nullable, required
    - `completedAt` string, date-time, nullable, required
    - `cancelledAt` string, date-time, nullable, required
    - `resultSummary` string, nullable, required
    - `error` string, nullable, required
    - `createdAt` string, date-time, required
    - `conversationId` string, uuid, nullable, required
    - `initiatedBy` object, nullable, required
      - `id` string, required
      - `fName` string, nullable, required
      - `lName` string, nullable, required
      - `email` string, required
    - `cronSchedule` object, nullable, required
      - `id` string, uuid, required
      - `name` string, required
    - `eventTrigger` object, nullable, required
      - `id` string, uuid, required
      - `name` string, nullable, required
      - `eventType` 'SCAN_STARTED' | 'SCAN_COMPLETE' | 'PR_SCAN_STARTED' | 'PR_SCAN_COMPLETE' | 'NEW_VULNERABILITIES_PR' | 'NEW_VULNERABILITIES_FULL_SCAN' | 'VULNERABILITY_PATCHED' | 'VULNERABILITY_REOPENED' | 'AUDIT_LOG_EVENT' | 'SCAN_FAILED' | 'SCAN_SCHEDULED' | 'LONG_RUNNING_SCAN' | 'PR_BLOCKED' | 'PR_MERGED_WITH_ISSUES' | 'REPORT_COMPLETE' | 'SCA_NEW_CVE' | 'SCA_NEW_ISSUE' | 'INBOUND_WEBHOOK' | 'PATCH_PR_DENIED' | 'VULNERABILITY_STATUS_CHANGED' | 'SCA_SCAN_COMPLETE' | 'SCA_SCAN_STARTED' | 'SCA_SCAN_FAILED' | 'REPO_ADDED' | 'RUNTIME_VALIDATION_FINISHED' | 'RUNTIME_VALIDATION_EXPLOITABLE' | 'RUNTIME_VALIDATION_NOT_EXPLOITABLE' | 'RUNTIME_VALIDATION_UNABLE' | 'CONTAINER_SCAN_STARTED' | 'CONTAINER_SCAN_COMPLETE' | 'CONTAINER_NEW_ISSUE' | 'ISSUE_AGED_PAST_THRESHOLD' | 'SLA_BURN_RATE_HIGH', required
    - `messages` object[], required
      - `id` string, uuid, required
      - `role` 'USER' | 'ASSISTANT' | 'TOOL_USE', required
      - `content` string, required
      - `toolName` string, nullable, required
      - `createdAt` string, date-time, required

## Other responses

- `400`: Error Response
- `401`: Error Response
- `403`: Error Response
- `404`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)