---
title: "Get trigger event details"
method: POST
path: "/api/v2/agent/getTriggerEvent"
tags: ["Agent"]
---

# Get trigger event details

`POST /api/v2/agent/getTriggerEvent`

## Request

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

Read an Assistant job with customer-visible messages, status, timing, and trigger references. EVENT context contains credential-redacted trigger metadata; CRON context contains schedule metadata; MANUAL and SLACK context is null. Raw tool results and internal diagnostics are omitted. getJob is the preferred operation for polling schedule results.

## Request body

- AgentGetTriggerEventRequest
  - `organizationId` string: Organization ID (injected by MCP server)
  - `jobId` string, uuid, required: The agent job ID to retrieve details for

## Response `200`

Job details with customer-visible messages and redacted trigger metadata

- AgentGetTriggerEventResponse
  - `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
    - `context` object, nullable, required

## Other responses

- `401`: 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)