> ## Documentation Index > Fetch the complete documentation index at: https://docs.hivenet.com/llms.txt > Use this file to discover all available pages before exploring further. # List regions > Returns every region instances can be launched in. Use a region's `name` as the `region` filter on `GET /presets` and `GET /instances`. This list is short and changes rarely, so it is returned in full rather than paginated. ## OpenAPI ````yaml /public-v1.yaml get /regions openapi: 3.0.3 info: title: Hive Compute Public API description: | The Hive Compute public API lets you manage compute instances and SSH keys programmatically, and browse the hardware presets and regions available to you. **Base URL:** `https://api.hivenet.com/v1` ## Authentication Every endpoint requires an API key, sent as a Bearer token: ``` Authorization: Bearer ``` API keys are issued manually at this release. Email [support@hivenet.com](mailto:support@hivenet.com) to request one. There is no self-service endpoint or console page for creating, listing or rotating keys yet; both will arrive in a later release. Treat the key as a password. It carries the full permissions of your account, does not expire on its own, and can only be replaced by contacting support. ## Scope Requests are scoped to the account the key belongs to. You can only see and act on your own instances and SSH keys. Regions and presets are the shared public catalogue and look the same to everyone. ## Errors Every error shares one envelope: ```json { "error": { "code": "NOT_FOUND", "message": "Instance 7f3c... not found", "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6" } } ``` Quote `request_id` when contacting support: it identifies the exact request in our logs. ## Rate limiting Requests are rate limited per key. Exceeding the limit returns `429` with a `Retry-After` header giving the number of seconds to wait. Treat the limit as subject to change and back off on `429` rather than pacing to a fixed number. ## Pagination List endpoints are cursor-paginated and return the same envelope: ```json { "data": [], "pagination": { "next": "opaque-cursor", "size": 50 } } ``` Pass `pagination.next` back as the `cursor` query parameter to fetch the following page. When it is `null` you have reached the last page. Cursors are opaque; do not construct or parse them. version: 1.0.0 contact: name: Hive Compute Support email: support@hivenet.com url: https://hivenet.com servers: - url: https://api.hivenet.com/v1 description: Production security: - bearerAuth: [] tags: - name: Instances description: > Compute instances are the core resource of the platform. Each instance runs a GPU-backed workload on a hardware preset in a region, and moves through this lifecycle: `CREATED → DEPLOYED → STARTING → RUNNING → STOPPING → STOPPED → TERMINATING → TERMINATED` A stopped instance can be started again and keeps its storage. A terminated instance is gone permanently and cannot be recovered. - name: SSH keys description: | Public keys used to reach your instances over SSH. A key you register is owned by your account and is not visible to anyone else. - name: Catalogue description: | The regions and hardware presets available to launch instances on. This is shared public reference data, identical for every caller. paths: /regions: get: tags: - Catalogue summary: List regions description: | Returns every region instances can be launched in. Use a region's `name` as the `region` filter on `GET /presets` and `GET /instances`. This list is short and changes rarely, so it is returned in full rather than paginated. operationId: listRegions responses: '200': description: The available regions. content: application/json: schema: type: array items: type: object properties: name: type: string description: The region identifier. example: eu-west '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: responses: Unauthorized: description: The API key is missing, malformed or not valid. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: Missing API token request_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 RateLimited: description: | Too many requests. Wait the number of seconds given in `Retry-After` before retrying. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: TOO_MANY_REQUESTS message: Too Many Requests request_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 InternalError: description: >- Something went wrong on our side. Retry, then contact support with the `request_id`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_ERROR message: Internal server error request_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 schemas: Error: type: object properties: error: type: object properties: code: type: string enum: - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - VALIDATION_ERROR - TOO_MANY_REQUESTS - INTERNAL_ERROR description: Stable, machine-readable error code. message: type: string description: Human-readable explanation. Do not match on this text. request_id: type: string description: Identifies this request in our logs. Quote it to support. securitySchemes: bearerAuth: type: http scheme: bearer description: | An API key issued by Hive Compute support. See **Authentication** above for how to request one. ````