Entities

Every entity has a stable, human-readable public identity — e.g. "openai" — that you use everywhere the Gateway takes an entity. You never need to look up or construct an internal id.

List entities

GET /v1/entities

[
  { "entity": "openai", "entityType": "AI_VENDOR", "displayName": "OpenAI" },
  { "entity": "anthropic", "entityType": "AI_VENDOR", "displayName": "Anthropic" }
]

Only entities with a stable public identity are listed. A retired entity is never listed.

Retrieve one entity

GET /v1/entities/{entity}

Returns the same shape as one list item, or ENTITY_NOT_FOUND if the identity doesn't resolve.

Stability

An entity's public identity is assigned once and never changes, never renamed, and never reused for a different entity — even if the entity's display name changes later. It is safe to hardcode.

Using it

Pass the identity as entity to Resolve Reality:

GET /v1/reality?entity=openai&factTopicSlug={topic}&scope={scopeJson}