Get a storage link
const url = 'https://qinto-api.blotout.io/teams/7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9/storage-links/a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://qinto-api.blotout.io/teams/7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9/storage-links/a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d \ --header 'Authorization: Bearer <token>'Returns one configuration: its parent, every child with what it shares, what each child set aside, and whether each site has caught up.
How it works
A child with sync.pending still has a deployment to land; nextSyncAttemptAt says when a failed one is retried. A removed child stays listed by its liveAliases and reverseBindingLive until both clear.
Required permissions
team:manage_storage_links:readon the team
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Unique id (UUID) of the team that owns the addressed resources, as shown in the team settings on the Blotout platform.
Example
7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9Unique id (UUID) of the team that owns the addressed resources, as shown in the team settings on the Blotout platform.
Unique id (UUID) of the storage link configuration.
Example
a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5dUnique id (UUID) of the storage link configuration.
Responses
Section titled “Responses”The configuration.
A storage link configuration with its parent, children and their selections.
object
Id of the configuration.
Name of the configuration.
When the configuration was created, as an ISO 8601 UTC timestamp.
When the configuration was last changed, as an ISO 8601 UTC timestamp.
The site whose storage is shared.
object
Id of the parent site.
Hostname of the parent site.
Whether the parent site has a deployed worker.
Whether a site has caught up with its link configuration.
object
Whether the site still has a deployment to land for its current link state.
How many times the pending deployment has failed in a row.
When the next retry is due, or null when none is scheduled.
The sites sharing the parent’s storage.
One child site of a configuration.
object
Id of the membership row.
Id of the child site.
Hostname of the child site.
What the child shares from the parent.
object
The app that declares the resource, or null for the identity graph.
That app’s slug, or null for the identity graph.
The resource identifier.
The kind of storage object.
Whether a site has caught up with its link configuration.
object
Whether the site still has a deployment to land for its current link state.
How many times the pending deployment has failed in a row.
When the next retry is due, or null when none is scheduled.
How many of the child’s bindings still point at the parent’s storage.
Whether the parent’s worker still carries a binding back to this child.
The child’s own app storage set aside while it shares the parent’s.
object
The app that declares the resource.
That app’s slug.
The resource identifier.
The kind of storage object.
Example
{ "storageLinkId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "name": "EU markets", "createdAt": "2026-09-21T10:04:31.000Z", "updatedAt": "2026-09-21T10:04:31.000Z", "parent": { "domainId": "3f2a9c81-5d47-4e0b-8c66-91b2a7f04d15", "domain": "www.example.com", "deployed": true, "sync": { "pending": false, "syncAttempts": 0, "nextSyncAttemptAt": "2026-09-21T10:04:31.000Z" } }, "children": [ { "storageLinkMemberId": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e", "domainId": "3f2a9c81-5d47-4e0b-8c66-91b2a7f04d15", "domain": "de.example.com", "selections": [ { "appId": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d", "appSlug": "facebook-capi", "identifier": "cache", "type": "kv" } ], "sync": { "pending": false, "syncAttempts": 0, "nextSyncAttemptAt": "2026-09-21T10:04:31.000Z" }, "liveAliases": 3, "reverseBindingLive": true, "parked": [ { "appId": "5a6b7c8d-9e0f-4a1b-8c2d-3e4f5a6b7c8d", "appSlug": "facebook-capi", "identifier": "cache", "type": "kv" } ] } ]}invalid_params — A path parameter failed validation (for example a malformed UUID); details pinpoints the offending parameter.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Field-level validation errors: a tree keyed by input property, each node carrying an errors array of human-readable messages. Render it to help the caller correct the request.
object
Example
{ "error": "invalid_params", "details": { "errors": [], "properties": { "teamId": { "errors": [ "Invalid UUID" ] } } }}unauthenticated — The Authorization: Bearer token is missing, malformed, or no longer valid. Generate a team API token or obtain a new OAuth access token.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "unauthenticated"}forbidden — The bearer credential lacks the required permission or belongs to another team, or its user lacks the organization role a developer operation needs. Update its policies, use a credential bound to the addressed team, or ask an organization owner for the role; message states the reason when one is known.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Human-readable reason for this specific failure, intended for display — do not parse it programmatically.
Example
{ "error": "forbidden", "message": "The Cloudflare API token is invalid or expired."}not_found — The addressed resource does not exist within this team; check the id and retry.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "not_found"}internal — Unexpected server error. Nothing is guaranteed to have been persisted; idempotent operations are safe to retry.
object
Machine-readable error slug; switch on this value rather than on the HTTP status alone.
Example
{ "error": "internal"}