GET
/api/agent-network/catalog/providersList Agent Network catalog providers
Returns the static catalog of supported Agent Network providers (OpenAI, Anthropic, …) along with their default upstream host, auth header template, brand color, and known models.
200A JSON Array of catalog providers
auth_header_templatestringrequired
Template the proxy uses to inject the API key (the literal string ${API_KEY} is replaced at request time).
brand_colorstringrequired
Hex brand color used to render the provider badge in the dashboard.
default_content_typestringrequired
Default Content-Type for upstream requests.
default_hoststringrequired
Default upstream host suggested when adding a provider of this type.
descriptionstringrequired
Short description shown in the provider picker.
extra_headersarray<object>optional
Catalog-declared list of optional per-provider routing/config headers the proxy stamps on every upstream request. Each entry surfaces an input on the dashboard's provider modal (one per item, labeled with `label`). Operators fill any subset; values land on the provider record's `extra_values` map keyed by `name`. Used by gateways like Portkey for `x-portkey-config: pc-...` (saved-config id resolving upstream provider + virtual key).
idstringrequired
Catalog provider identifier (referenced by AgentNetworkProvider.provider_id).
identity_injectionobjectoptional
Catalog-declared identity-injection shape. Present when this provider supports stamping the caller's NetBird identity onto upstream requests. Exactly one of `header_pair` or `json_metadata` is set per provider entry. The dashboard reads the `customizable` flag on whichever shape is present to decide whether to surface the labels as editable inputs (true → editable with the catalog values shown as placeholders; false → fixed and read-only).
kindstringrequired
Presentation grouping for the provider Select on the dashboard.
"provider" — first-party vendor API (OpenAI, Anthropic, …); the upstream is the model itself.
"gateway" — routing/aggregation layer in front of multiple providers (LiteLLM, Portkey, …); typically pairs with NetBird identity stamping.
"custom" — generic OpenAI-compatible self-hosted endpoint catch-all.
modelsarray<object>required
Catalog models available for this provider.
namestringrequired
Display name for the provider.
pricing_surfacesarray<string>optional
Cost-meter pricing surfaces this provider's traffic is metered under ("openai", "anthropic", "bedrock"). Tells the dashboard which cache-rate fields apply to this provider's models: "openai" → cached_input_per_1k (cached prompt tokens are a subset of input); "anthropic"/"bedrock" → cache_read_per_1k + cache_creation_per_1k (additive buckets). Absent/empty for gateway and custom entries, whose upstream shape NetBird cannot know ahead of time — surface all cache fields for those.
401Requires authentication
403Forbidden
500Internal Server Error
Error handling
A 401 is returned: Requires authentication. A 403 is returned: Forbidden. A 500 is returned: Internal Server Error.