Skip to main content
GET
List project machine pool grants

Authorizations

Authorization
string
header
required

An opaque Omnara personal or organization bearer token.

Path Parameters

orgID
string
required

Organization ID (org_...).

Pattern: ^org_[a-z2-7]{26}$
projectID
string
required

Project ID (proj_...).

Pattern: ^proj_[a-z2-7]{26}$

Query Parameters

name
string

Case-insensitive glob over the list's logical name. * matches zero or more characters, ? matches one character, and \ escapes a wildcard.

Required string length: 1 - 200
machine_pool_id
string

Return only the grant for this machine pool. Machine pool ID (mpo_...).

Pattern: ^mpo_[a-z2-7]{26}$
sort
enum<string>
default:-created_at

Sort order for named resources that expose created and modified timestamps.

Available options:
name,
-name,
-updated_at,
updated_at,
-created_at,
created_at
limit
integer<int32>
default:50

Maximum number of items to return in one page.

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor from a previous response's next_cursor. Omit for the first page.

Maximum string length: 1024

Response

Project machine pool grants.

data
object[]
required
next_cursor
string | null
required