{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/linkbreakers-com/json-schema/linkbreakers-com-list-api-scopes-response-schema.json",
  "title": "ListApiScopesResponse",
  "description": "ListApiScopesResponse lists every scope a token can hold.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/linkbreakers-com-api-scopes-api-openapi.yml#/components/schemas/ListApiScopesResponse",
  "properties": {
    "scopes": {
      "description": "Every scope, ordered by resource then read before write.",
      "items": {
        "$ref": "#/$defs/ApiScopeInfo",
        "type": "object"
      },
      "type": "array"
    }
  },
  "type": "object",
  "$defs": {
    "ApiScopeAccess": {
      "default": "API_SCOPE_ACCESS_UNSPECIFIED",
      "description": "ApiScopeAccess is what a scope allows on its resource.\n\n - API_SCOPE_ACCESS_UNSPECIFIED: Not set.\n - API_SCOPE_ACCESS_READ: Reads only.\n - API_SCOPE_ACCESS_WRITE: Reads and writes.",
      "enum": [
        "API_SCOPE_ACCESS_UNSPECIFIED",
        "API_SCOPE_ACCESS_READ",
        "API_SCOPE_ACCESS_WRITE"
      ],
      "type": "string"
    },
    "ApiScopeInfo": {
      "description": "ApiScopeInfo describes one scope for people and agents choosing scopes.",
      "properties": {
        "access": {
          "$ref": "#/$defs/ApiScopeAccess",
          "description": "Whether the scope reads or writes the resource."
        },
        "description": {
          "description": "What the scope allows.",
          "type": "string"
        },
        "name": {
          "description": "The scope string as it appears in OAuth grants and error messages (e.g. links:read).",
          "type": "string"
        },
        "resource": {
          "description": "The resource the scope covers (e.g. links).",
          "type": "string"
        },
        "scope": {
          "description": "ApiScope is one permission an API token or OAuth grant can hold.\n\nA write scope also grants the read scope of the same resource.\n\n - API_SCOPE_UNSPECIFIED: Not a scope. Rejected wherever a scope is expected.\n - API_SCOPE_LINKS_READ: Read links, their QR code images, tags, folders and link settings.\n - API_SCOPE_LINKS_WRITE: Create, update and delete links, tags, folders and link settings.\n - API_SCOPE_WORKFLOWS_READ: Read the workflow steps behind a link and validate them.\n - API_SCOPE_WORKFLOWS_WRITE: Create, connect, update, lay out and delete workflow steps.\n - API_SCOPE_QRCODES_READ: Read QR code designs and QR code templates.\n - API_SCOPE_QRCODES_WRITE: Change QR code designs and create, publish and delete QR code templates.\n - API_SCOPE_PAGE_THEMES_READ: Read page themes and page theme templates.\n - API_SCOPE_PAGE_THEMES_WRITE: Change page themes and create, publish and delete page theme templates.\n - API_SCOPE_MEDIA_READ: Read uploaded media.\n - API_SCOPE_MEDIA_WRITE: Upload and delete media.\n - API_SCOPE_DOMAINS_READ: Read custom domains and their DNS instructions.\n - API_SCOPE_DOMAINS_WRITE: Add, verify, update and delete custom domains.\n - API_SCOPE_VISITORS_READ: Read and search visitors and their attributes.\n - API_SCOPE_VISITORS_WRITE: Identify, update and delete visitors and their attributes.\n - API_SCOPE_ANALYTICS_READ: Read events, metrics, time series, analytics data and dashboards.\n - API_SCOPE_ANALYTICS_WRITE: Create, update and delete analytics dashboards and generate widget summaries.\n - API_SCOPE_WEBHOOKS_READ: Read webhooks.\n - API_SCOPE_WEBHOOKS_WRITE: Create, update and delete webhooks.\n - API_SCOPE_INTEGRATIONS_READ: Read the Slack and Google Forms integrations.\n - API_SCOPE_INTEGRATIONS_WRITE: Connect, configure, test, sync and disconnect the Slack and Google Forms integrations.\n - API_SCOPE_WORKSPACE_READ: Read the workspace and its settings.\n - API_SCOPE_WORKSPACE_WRITE: Update the workspace, request enrollment and delete the workspace.\n - API_SCOPE_MEMBERS_READ: Read workspace members.\n - API_SCOPE_MEMBERS_WRITE: Update, revoke, sign out and remove members. Inviting a member or changing a sign-in email or password needs full access.\n - API_SCOPE_TOKENS_READ: Read API tokens and their scopes, never their secrets.\n - API_SCOPE_TOKENS_WRITE: Create, update and delete API tokens, limited to the scopes the calling token holds.\n - API_SCOPE_BILLING_WRITE: Open checkout, credit top-up and billing portal sessions.\n - API_SCOPE_ASSISTANT_READ: Read the Assistant conversation.\n - API_SCOPE_ASSISTANT_WRITE: Send files to the Assistant, clear the conversation and contact support.",
          "enum": [
            "API_SCOPE_UNSPECIFIED",
            "API_SCOPE_LINKS_READ",
            "API_SCOPE_LINKS_WRITE",
            "API_SCOPE_WORKFLOWS_READ",
            "API_SCOPE_WORKFLOWS_WRITE",
            "API_SCOPE_QRCODES_READ",
            "API_SCOPE_QRCODES_WRITE",
            "API_SCOPE_PAGE_THEMES_READ",
            "API_SCOPE_PAGE_THEMES_WRITE",
            "API_SCOPE_MEDIA_READ",
            "API_SCOPE_MEDIA_WRITE",
            "API_SCOPE_DOMAINS_READ",
            "API_SCOPE_DOMAINS_WRITE",
            "API_SCOPE_VISITORS_READ",
            "API_SCOPE_VISITORS_WRITE",
            "API_SCOPE_ANALYTICS_READ",
            "API_SCOPE_ANALYTICS_WRITE",
            "API_SCOPE_WEBHOOKS_READ",
            "API_SCOPE_WEBHOOKS_WRITE",
            "API_SCOPE_INTEGRATIONS_READ",
            "API_SCOPE_INTEGRATIONS_WRITE",
            "API_SCOPE_WORKSPACE_READ",
            "API_SCOPE_WORKSPACE_WRITE",
            "API_SCOPE_MEMBERS_READ",
            "API_SCOPE_MEMBERS_WRITE",
            "API_SCOPE_TOKENS_READ",
            "API_SCOPE_TOKENS_WRITE",
            "API_SCOPE_BILLING_WRITE",
            "API_SCOPE_ASSISTANT_READ",
            "API_SCOPE_ASSISTANT_WRITE"
          ]
        }
      },
      "type": "object"
    }
  }
}