Scope

Many facts aren't a single global answer — they depend on conditions. scope is the canonical JSON object that names exactly which instance of a fact you're resolving.

Example

{
  "product": "openai_api",
  "organization_retention_mode": "STANDARD"
}

Discovering the required shape

Never guess a scope's keys from prose. Fetch the topic and read its scopeSchema — a real JSON Schema, not a second, informal description:

GET /v1/topics/{topic}

Rules

  • Empty scope {} is valid for a fact that has no conditional dimensions.
  • A missing scope parameter is rejected — omission is not the same as "no scope".
  • Key order and formatting never matter — AIality canonicalizes scope internally before identifying it, so equivalent JSON always resolves to the same fact instance.
  • You never compute or pass a scope hash yourself — AIality derives it internally.