Skip to main content
A client never names a provider URL — it names a model, and TrustGate resolves which registry to use. The model field accepts three forms.

Model reference syntax

Model policies

Consumers and roles can constrain which models are reachable per registry with model_policies:
  • allowed — the allow-list of models for that registry. Empty/omitted means all models are permitted.
  • default — used when the request names no model; it must be a member of allowed.
A request for a model outside the allow-list is rejected before it reaches the provider.

Resolution order

  1. Parse the model reference (short / qualified / pool).
  2. Narrow the candidate registries (the consumer’s registry_ids or the pool members, filtered by provider for qualified refs).
  3. Apply model_policies — reject disallowed models; fill in the default when none was given.
  4. Hand the candidates to the load balancer to pick one, with fallback on failure.