Nirvana Labs API | Operations › List Operations

API Reference

Operations

operations

Methods

Get Operation Details ->

Operation

get/v1/operations/{operation_id}

Get details about a specific operation

List Operations -> Cursor<

Operation

get/v1/operations

List all operations

query Parameters

cursor: string

Optional

Pagination cursor returned by a previous request

limit: number

Optional

(maximum: 100, minimum: 10, default: 100)

Maximum number of items to return

Response fields

OperationList

Request example

curl https://api.nirvanalabs.io/v1/operations \
    -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"

200Example

{
  "items": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-01-01T00:00:00Z",
      "kind": "vm",
      "resource_id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "pending",
      "type": "create",
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
    "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
    "total_count": 125
  }
}

Domain types

Operation = { id, created_at, kind, 4 more... }

Operation details.

OperationKind = "vm" | "volume" | "vpc" | 1 more...

Kind of Operation.

OperationList = { items, pagination }

OperationStatus = "pending" | "running" | "done" | 2 more...

Status of the Operation.

OperationType = "create" | "update" | "delete" | 1 more...

Type of Operation.