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 the volume transfer offers this project has open
The offers made BY this project that nobody has accepted yet. An accepted or withdrawn
offer disappears from this list — there is no terminal-state history here, because the
provider keeps none and inventing one locally would mean a second source of truth that
drifts.
No authKey appears in any row. It exists only in the create response.
Validation: scopeId must resolve to a scope the caller can access (unknown → 404).
RBAC: any scope role may read.
Async & state: Synchronous read; no state change.
Errors: 401; 403; 404; 500.
Idempotency/Concurrency: Safe; no idempotency key.
bearerTokenAuthorizationBearer <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.
scopeId*stringOpaque ownership+authorization scope resolving to tenant + subscription + project.
page?integer1-based page number.
1 <= value1pageSize?integerItems per page (max 200). Lists that used to return every row default to the maximum, so a client that does not page keeps seeing up to 200 rows; a larger value is refused with 422.
1 <= value <= 200200The open offers, newest first.
application/json- response
data*array<>curl -X GET "https://example.com/scopes/string/storage/volume-transfers"{ "data": [ { "id": "string", "volumeId": "string", "volumeName": "string", "name": "string", "createdAt": "2019-08-24T14:15:22Z" } ]}