Version 2.1.1792967583 · latest Download OpenAPI Markdown

Regions

Geographic regions used to categorize nodes and node groups.

regionsNode schedulingAuthentication: Admin only5 endpoints

List regions

GET/api/v2/regions
Authentication: Admin only

Query parameters

FieldTypeRequiredDescription
pageinteger— Page number, starting from 1
Default 1
page_sizeinteger— Items per page
Default 20
sortstring— Sort fields, comma-separated; prefix `-` for descending, e.g. `-created_at,id`

Create region

POST/api/v2/regions
Authentication: Admin only

Request body application/json

FieldTypeRequiredDescription
desstring— Description
namestringRequired Name

Get region

GET/api/v2/regions/{id}
Authentication: Admin only

Update region

PUT/api/v2/regions/{id}
Authentication: Admin only

Request body application/json

FieldTypeRequiredDescription
desstring— Description
namestring— Name

Delete region

DELETE/api/v2/regions/{id}
Authentication: Admin only

Regions object

FieldTypeRequiredDescription
created_atstring— Created at
read-only
desstring— Description
idinteger— Record ID
read-only
namestring— Name
updated_atstring— Updated at
read-only