io.atcr.hold.getQuota Documentation (EN)

main query

Get storage quota information for a user. Calculates total unique blob storage by iterating layer records and deduplicating by digest.

Parameters

userDid string did Required

DID of the user to get quota for

Output

Encodingapplication/json

limit integer Optional

Storage limit in bytes (absent if unlimited)

tier string Optional

Quota tier name (e.g., 'deckhand', 'bosun', 'quartermaster')

totalSize integer Required

Total size in bytes of unique blobs

uniqueBlobs integer Required

Number of unique blob digests

userDid stringdid Required

DID of the user

Errors

InvalidUserDid

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

userDid * DID of the user to get quota for

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "InvalidUserDid"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "userDid",
        "uniqueBlobs",
        "totalSize"
      ],
      "properties": {
        "tier": {
          "type": "string",
          "maxLength": 32,
          "description": "Quota tier name (e.g., 'deckhand', 'bosun', 'quartermaster')"
        },
        "limit": {
          "type": "integer",
          "description": "Storage limit in bytes (absent if unlimited)"
        },
        "userDid": {
          "type": "string",
          "format": "did",
          "description": "DID of the user"
        },
        "totalSize": {
          "type": "integer",
          "description": "Total size in bytes of unique blobs"
        },
        "uniqueBlobs": {
          "type": "integer",
          "description": "Number of unique blob digests"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "userDid"
    ],
    "properties": {
      "userDid": {
        "type": "string",
        "format": "did",
        "description": "DID of the user to get quota for"
      }
    }
  },
  "description": "Get storage quota information for a user. Calculates total unique blob storage by iterating layer records and deduplicating by digest."
}