List available API key scopes

GEThttps://app.speybooks.com/api/v1/api-keys/scopes

Returns the complete scope catalogue including wildcard, global, and per-resource scopes. Use this to populate scope selection UI or validate scope strings before creating a key.

Response

200Returns all valid scopes grouped by category (wildcard, global, per-resource).

Show response fields

categoriesobject

Show child attributes

wildcardobject

Show child attributes

descriptionstring

scopestring

scopesarray<string>

RequestGET/v1/api-keys/scopescurl

curl https://api.speybooks.com/v1/api-keys/scopes \
  -H "Authorization: Bearer sk_test_..."

Response200

{
  "success": true,
  "data": {
    "scopes": [
      "*",
      "read",
      "write",
      "invoices",
      "invoices:read",
      "invoices:write"
    ],
    "categories": {
      "wildcard": {
        "scope": "*",
        "description": "Full access to all resources"
      }
    }
  }
}