Skip to main content
GET
List virtual GPU clusters

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234$abcdef

Path Parameters

project_id
integer
required

Project ID

Example:

1

region_id
integer
required

Region ID

Example:

7

Query Parameters

created_at
DateTimeRangeFilter · object

Filter by creation time (UTC), e.g. created_at[gte]=2026-01-01T00:00:00Z.

flavor
StringFilter · object

Filter by flavor (case-insensitive), e.g. flavor[prefix]=g3-, flavor[exact]=g3-ai-32-192-1500-l40s-48-1.

ids
string<uuid4>[]

Return only clusters with these IDs, e.g. ids=<id1>&ids=<id2>.

Example:
limit
integer
default:10

Limit of items on a single page

Required range: x <= 1000
Example:

10

name
StringFilter · object

Filter by name (case-insensitive), e.g. name[contains]=gpu, name[prefix]=prod-.

offset
integer
default:0

Offset in results list

Required range: x >= 0
Example:

0

servers_count
IntRangeFilter · object

Filter by node count, e.g. servers_count[gte]=2, servers_count[gte]=2&servers_count[lt]=8.

tag_key
StringFilter · object

Filter by tag key regardless of value, e.g. tag_key[contains]=team.

tag_value
StringFilter · object

Filter by tag value regardless of key, e.g. tag_value[prefix]=prod.

tags
TagFilter · object

Filter by exact tag key-value pairs, e.g. tags[env]=prod&tags[team]=core. Pairs are ANDed; values match case-insensitively.

Example:
updated_at
DateTimeRangeFilter · object

Filter by last-change time (UTC), e.g. updated_at[gte]=2026-06-01T00:00:00Z.

Response

200 - application/json

OK

count
integer
required

Number of objects

Required range: x >= 0
Example:

1

results
VirtualClusterSerializer · object[]
required

Objects