---
title: "List recent jobs and workflow metadata"
method: GET
path: "/v1/jobs"
---

# List recent jobs and workflow metadata

`GET /v1/jobs`

## Request

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

## Query parameters

- `limit` integer

## Response `200`

Job list

- object
  - `jobs` Job[], required
    - `id` string, uuid, required: Job identifier.
    - `workspaceId` string, uuid, required: Workspace that owns the job.
    - `action` string, required: Catalog action name, for example integration.execute.
    - `workflowId` string, nullable, required: Caller-supplied workflow identifier shared across related jobs.
    - `workflowName` string, nullable, required: Caller-supplied workflow name shown in the dashboard.
    - `status` 'awaiting_approval' | 'queued' | 'running' | 'succeeded' | 'failed' | 'rejected' | 'execution_unknown', required: awaiting_approval, queued, and running are non-terminal; succeeded, failed, rejected, and execution_unknown are terminal. An owner may revoke a queued approval, producing rejected with both approval and rejection evidence.
    - `input` object, required: Validated action input exactly as submitted.
    - `output` unknown, required
    - `error` string, nullable, required: Failure, execution_unknown or queued approval revocation explanation; null otherwise.
    - `sideEffect` boolean, required: True when the action writes to an external system and therefore required owner approval.
    - `idempotencyKey` string, nullable, required: Idempotency key that deduplicates this submission within the workspace.
    - `approvedAt` string, date-time, nullable, required: When a signed-in workspace owner released the write.
    - `approvedBy` string, nullable, required: Owner who approved the write.
    - `rejectedAt` string, date-time, nullable, required: When a signed-in workspace owner rejected the write.
    - `rejectedBy` string, nullable, required: Owner who rejected the write.
    - `createdAt` string, date-time, required: Creation time.
    - `updatedAt` string, date-time, required: Last status change.

## 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)