---
title: "List job and callback events"
method: GET
path: "/v1/events"
---

# List job and callback events

`GET /v1/events`

## Request

- Base URL: `https://actiondock.app`
- URL: `https://actiondock.app/v1/events`
- Auth: HTTP bearer

## Query parameters

- `limit` integer

## Response `200`

Event list

- object
  - `events` JobEvent[], required
    - `id` string, uuid, required: Event identifier; also the callback delivery reference.
    - `workspaceId` string, uuid, required: Workspace that owns the event.
    - `type` 'job.approval_requested' | 'job.approved' | 'integration.policy.accepted' | 'job.succeeded' | 'job.failed' | 'job.rejected' | 'job.execution_unknown' | 'callback.test', required: Terminal job events are also delivered to the signed callback.
    - `payload` unknown, required
    - `externalId` string, nullable, required: Deduplication reference such as job:succeeded:<jobId>.
    - `createdAt` string, date-time, required: Event time.

## Other responses

- `401`: Missing, invalid, or revoked workspace API key.
- `404`: Resource not found or outside the caller's workspace.
- `429`: Rate limit exceeded (rate_limit_exceeded).

---

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