List jobs

List an application's jobs, one page at a time. Each entry is a compact summary; fetch a job's full result from /v1/jobs/{jobId}.

GET /v1/jobs

Request

GET /v1/jobs
Authorization: Bearer {api_key}

Query parameters

Parameter	Type	Description	Required
applicationId	`string (uuid)`	The application whose jobs to list. Must be the application the API key belongs to; any other value returns `unauthorized`.	Yes
page	`integer`	Page to return, counted from 1.	No
pageSize	`integer`	Number of jobs per page. Values above 100 are clamped to 100, not rejected.	No

Example request

curl -X GET "https://api.pixelsystems.com/v1/jobs?applicationId=660e8400-e29b-41d4-a716-446655440001&page=1&pageSize=20" \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json"

Response (200)

Paginated list of jobs

Field	Type	Description
jobs	`array<JobSummary>`	Jobs for the application, newest first. Each entry is a compact summary; `GET /v1/jobs/{jobId}` returns the full result.
pagination	`PaginationMeta`	Page-based pagination metadata for list responses.

Example response

{
  "jobs": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "applicationId": "660e8400-e29b-41d4-a716-446655440001",
      "metadata": {},
      "createdAt": "2024-06-01T12:00:00Z",
      "updatedAt": "2024-06-01T12:05:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "pageSize": 20,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": false
  }
}