Compute

Preview — pending review

This reference is generated from the platform API contract and is still under review. Operations, fields, and descriptions can change before publication.

List an instance's add-on/license attachments

GET
/scopes/{scopeId}/compute/instances/{instanceId}/catalog-items

Returns the add-ons and licenses (catalog) attached to an instance, each with its chosen billing period and the unit price FROZEN at attach time. Drives the instance-detail Extensions panel and the billing drill-down. Includes detached (post-delete) attachments so history survives; state distinguishes active from detached. Validation: scopeId must be accessible and instanceId must be visible to the caller. Async & state: Synchronous read; no state change.

Authorization

bearerToken
headerAuthorizationBearer <token>

An API token (pc_live_…) or a service-account key (sak_live_…), created in Identity & Access Management and sent as Authorization: Bearer <token>. Requests are rate limited per credential and per tenant: every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and a refused request gets 429 RATE_LIMITED with Retry-After.

Path Parameters

scopeId*string

Opaque ownership+authorization scope resolving to tenant + subscription + project.

instanceId*string

Identifier of the compute instance.

Response Body

The instance's add-on/license attachments.

application/json
  1. response
items*array<>
curl -X GET "https://example.com/scopes/string/compute/instances/string/catalog-items"
{  "items": [    {      "id": "string",      "instanceId": "string",      "kind": "addon",      "itemId": "string",      "slug": "string",      "name": "string",      "period": "hour",      "unitPriceMinor": 0,      "currency": "string",      "state": "active",      "createdAt": "2019-08-24T14:15:22Z",      "detachedAt": "2019-08-24T14:15:22Z"    }  ]}