Skip to content
Blotout Docs

List storage links

GET
/teams/{teamId}/storage-links
curl --request GET \
  --url 'https://qinto-api.blotout.io/teams/7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9/storage-links?limit=50&cursorAt=2026-09-21T10%3A04%3A31.000Z&cursorId=a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d' \
  --header 'Authorization: Bearer <token>'

Lists the team’s storage link configurations newest first, each with its parent site and how many sites share that parent’s storage.

How it works

Page with cursorAt and cursorId from the previous response’s nextCursor; a null cursor means the last page.

Required permissions

  • team:manage_storage_links:read on the team

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
teamId
required

Unique id (UUID) of the team that owns the addressed resources, as shown in the team settings on the Blotout platform.

string format: uuid

Example 

7b8d1a52-6c1e-4b6f-9a30-2f8a54d1c3e9

Unique id (UUID) of the team that owns the addressed resources, as shown in the team settings on the Blotout platform.

Query Parameters

Section titled “Query Parameters”
limit

How many configurations to return, 1–200.

integer
>= 1 <= 200

Example 

50

How many configurations to return, 1–200.

cursorAt

Continue after this configuration’s creation instant, from a previous response’s cursor.

string format: date-time

Example 

2026-09-21T10:04:31.000Z

Continue after this configuration’s creation instant, from a previous response’s cursor.

cursorId

Continue after this configuration’s id, from a previous response’s cursor. Send it with cursorAt.

string

Example 

a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d

Continue after this configuration’s id, from a previous response’s cursor. Send it with cursorAt.

Responses

Section titled “Responses”

200

Section titled “200”

The page of configurations.

Media typeapplication/json
object
records
required

The page of configurations, newest first.

Array<object>

One storage link configuration in a team’s list.

object
storageLinkId
required

Id of the configuration.

string
name
required

Name of the configuration.

string
parent
required

The site whose storage is shared.

object
domainId
required

Id of the parent site.

string
domain
required

Hostname of the parent site.

string
childCount
required

How many sites share the parent’s storage.

integer
createdAt
required

When the configuration was created, as an ISO 8601 UTC timestamp.

string format: date-time
nextCursor
required

Where the next page starts, or null on the last one.

object
at
required

Pass as cursorAt.

string
id
required

Pass as cursorId.

string

Example 

{
  "records": [
    {
      "storageLinkId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "name": "EU markets",
      "parent": {
        "domainId": "3f2a9c81-5d47-4e0b-8c66-91b2a7f04d15",
        "domain": "www.example.com"
      },
      "childCount": 2,
      "createdAt": "2026-09-21T10:04:31.000Z"
    }
  ],
  "nextCursor": {
    "at": "2026-09-21T10:04:31.000Z",
    "id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
  }
}

400

Section titled “400”

invalid_params — A path parameter failed validation (for example a malformed UUID); details pinpoints the offending parameter.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: invalid_params
details

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
key
additional properties

Example 

{
  "error": "invalid_params",
  "details": {
    "errors": [],
    "properties": {
      "teamId": {
        "errors": [
          "Invalid UUID"
        ]
      }
    }
  }
}

401

Section titled “401”

unauthenticated — The Authorization: Bearer token is missing, malformed, or no longer valid. Generate a team API token or obtain a new OAuth access token.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: unauthenticated

Example 

{
  "error": "unauthenticated"
}

403

Section titled “403”

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.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: forbidden
message

Human-readable reason for this specific failure, intended for display — do not parse it programmatically.

string

Example 

{
  "error": "forbidden",
  "message": "The Cloudflare API token is invalid or expired."
}

500

Section titled “500”

internal — Unexpected server error. Nothing is guaranteed to have been persisted; idempotent operations are safe to retry.

Media typeapplication/json
object
error
required

Machine-readable error slug; switch on this value rather than on the HTTP status alone.

string
Allowed values: internal

Example 

{
  "error": "internal"
}