---
title: "Browse the signed-in owner's jobs by status"
method: GET
path: "/v1/dashboard/jobs"
---

# Browse the signed-in owner's jobs by status

`GET /v1/dashboard/jobs`

## Request

- Base URL: `https://actiondock.app`
- URL: `https://actiondock.app/v1/dashboard/jobs`
- Auth: API key in cookie `actiondock_dashboard`

The signed-in owner can filter Workflows and jobs by status and load older jobs, including approvals and execution_unknown records outside the recent overview. GET /v1/dashboard/jobs accepts status, limit (1-100, default 50), and a before job UUID; follow nextBefore until null. Results are newest first by creation time and ID, scoped to the owner workspace. These are live pages, not a snapshot; refresh to see new jobs or changed statuses. Agent API keys cannot use this owner endpoint; MCP tools and agent job reads keep their existing contracts.

## Query parameters

- `status` 'awaiting_approval' | 'queued' | 'running' | 'succeeded' | 'failed' | 'rejected' | 'execution_unknown'
- `limit` integer
- `before` string, uuid

## Response `200`

Matching jobs, newest first; no state change or provider call

- 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.
  - `nextBefore` string, uuid, nullable, required: Older-page cursor, or null when no further matching jobs were found.

## Other responses

- `400`: Invalid status, limit or cursor.
- `401`: A signed-in owner session is required; API keys are not accepted.
- `404`: Cursor job not found in this workspace.

---

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