Skip to content

List published S3 endpoints and addressing styles

  • Method: GET
  • Path: /v1/orgs/{org}/s3/endpoints
  • Operation ID: listEndpoints
  • Tag: Object storage

Send Authorization: Bearer <credential>. The credential is either an API key (vsk_…) created for an organization, or an OIDC access token obtained by signing in to VirtScale.

Name Type Required Description
org string (uuid) Yes The organization’s id.
Field Type Required Enum Description
items array of EndpointOut Yes
items.addressing string Yes
items.region string Yes
items.url string Yes
next_cursor string, nullable No

Every error response is application/problem+json (schema Problem).

Status Meaning
401 The credential is missing or invalid.
404 The resource does not exist.
default Any other status is possible; the code field identifies the error.
curl "https://api.virtscale.nl/v1/orgs/$ORG_ID/s3/endpoints" \
  -H "Authorization: Bearer $VIRTSCALE_API_KEY"