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

# POST /api/v1/jobGroups

`POST /api/v1/jobGroups`

## Query parameters

- `backend` 'jsonb'

## Request body

- object
  - `filters` Filter[], nullable, required — Filters to apply to jobs before grouping.
    - `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
  - `groupedField` object, required
    - `field` string, required — Field or annotation key to group by
    - `isAnnotation` boolean
    - `lastTransitionTimeAggregate` 'latest' | 'earliest' | 'average', nullable — Type of aggregate to use for lastTransitionTime (latest, earliest, average)
  - `aggregates` string[], nullable, required — Additional fields to compute aggregates on
  - `skip` integer — First elements to ignore from the full set of results. Used for pagination.
  - `take` integer — Number of job groups to fetch.

## Response `200`

Returns job groups from API

- object
  - `groups` Group[], required — List of Job groups
    - `name` string, required
    - `count` integer, required
    - `aggregates` object, 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)