---
title: "POST /api/v1/jobs"
method: POST
path: "/api/v1/jobs"
---

# POST /api/v1/jobs

`POST /api/v1/jobs`

## Query parameters

- `backend` 'jsonb'

## Request body

- object
  - `filters` Filter[], nullable, required — Filters to apply to jobs.
    - `field` string, required
    - `value` object, required
    - `match` 'exact' | 'anyOf' | 'startsWith' | 'contains' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqualTo' | 'lessThanOrEqualTo' | 'exists', required
    - `isAnnotation` boolean
  - `order` Order, required
    - `field` string, required
    - `direction` 'ASC' | 'DESC', required
  - `activeJobSets` boolean — Only include jobs in active job sets
  - `skip` integer — First elements to ignore from the full set of results. Used for pagination.
  - `take` integer — Number of jobs to fetch.

## Response `200`

Returns jobs from API

- object
  - `jobs` Job[] — List of jobs found
    - `jobId` string, required
    - `queue` string, required
    - `owner` string, required
    - `namespace` string, nullable
    - `jobSet` string, required
    - `cpu` integer, required
    - `memory` integer, required
    - `ephemeralStorage` integer, required
    - `gpu` integer, required
    - `priority` integer, required
    - `priorityClass` string, nullable
    - `submitted` string, date-time, required
    - `cancelled` string, date-time, nullable
    - `state` 'QUEUED' | 'PENDING' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'PREEMPTED' | 'LEASED' | 'REJECTED', required
    - `lastTransitionTime` string, date-time, required
    - `lastActiveRunId` string, nullable
    - `duplicate` boolean, required
    - `annotations` object, required
    - `runs` Run[], required
      - `runId` string, required
      - `cluster` string, required
      - `node` string, nullable
      - `leased` string, date-time, nullable
      - `pending` string, date-time, nullable
      - `started` string, date-time, nullable
      - `finished` string, date-time, nullable
      - `jobRunState` 'RUN_PENDING' | 'RUN_RUNNING' | 'RUN_SUCCEEDED' | 'RUN_FAILED' | 'RUN_TERMINATED' | 'RUN_PREEMPTED' | 'RUN_UNABLE_TO_SCHEDULE' | 'RUN_LEASE_RETURNED' | 'RUN_LEASE_EXPIRED' | 'RUN_MAX_RUNS_EXCEEDED' | 'RUN_LEASED' | 'RUN_CANCELLED', required
      - `exitCode` integer, nullable
      - `pool` string, nullable
      - `ingressAddresses` object
      - `failureCategory` string
      - `failureSubcategory` string
    - `cancelReason` string, nullable
    - `cancelUser` string, nullable
    - `node` string, nullable
    - `cluster` string, required
    - `pool` string, nullable
    - `exitCode` integer, nullable
    - `runtimeSeconds` integer, required

## Other responses

- `400` — Error response
- `default` — Error response

---

[API](https://skmtc.dev/armadaproject/apis/lookout-v2-api.md) · [All operations](https://skmtc.dev/armadaproject/apis/lookout-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/armadaproject/lookout-v2-api/revisions/a22f99d5fd2b/schema)