Sizes and regions ›
List sizes
GET
/v1/sizesList sizes.
Requestcurl
- curl https://agental.io/v1/sizes \
- -H "Authorization: Bearer $AGENTAL_API_KEY"
Answer200 OK · Catalog
- {
- "region": string,
- "regions": string[],
- "used": integer,
- "sizes": [{
- "name": "tiny" | "small" | "medium" | "large",
- "vcpu": integer,
- "memoryMb": integer,
- "diskGb": integer,
- }],
- "vmIsolation": boolean,
- }
The regions, the fixed sizes, and how many sandboxes there are.
Headers
AuthorizationrequiredBearer key | An API key that may make this call. |
Returns
200 The regions, the fixed sizes, and how many sandboxes there are.
Catalog5 fields
regionstring
The default region: where a create that names none is made.
regionsstring[]
The regions sandboxes can be made in now, the default first.
More
GET /v1/regions says more of each.usedinteger
sizesobject[]4 fields
nametinysmallmediumlarge
vcpuinteger
memoryMbinteger
diskGbinteger
vmIsolationboolean
Whether sandboxes run in their own virtual machines.
Errors and other answers
| 404 | Not found. |
Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.