Skip to main content

Get AI Provider

Returns one AI provider's configuration, in the same masked shape as a row of List AI Providers. A provider that has never been saved comes back as a not-configured stub (configured: false) rather than an error. An unsupported provider key is refused.

Platform owner only. The caller's node must be the platform root node; any other caller is refused with 403 / 10005.

Required permission: ai-provider:view

Request​

GET /v2/admin/ai-providers/{provider}

Parameters​

NameTypeInDescription
providerstringpathRequired. Provider key: claude or openai

Headers​

NameDescription
AuthorizationRequired. Bearer <access_token>

Example​

curl --request GET \
--url '{{baseUrl}}/v2/admin/ai-providers/claude' \
--header 'Authorization: Bearer <access_token>'

Response​

{
"provider": "claude",
"base_url": "https://api.anthropic.com",
"model": "claude-sonnet-4-5",
"image_model": "",
"timeout": 60,
"max_tokens": 1024,
"is_enabled": true,
"features": ["tokenization_suggestion", "support_assistant"],
"api_key_set": true,
"api_key_last4": "Qx3A",
"configured": true,
"created_at": "2026-10-24T09:03:17.442Z",
"updated_at": "2026-10-30T15:41:08.106Z"
}

Response Fields​

The fields are described on List AI Providers.

Errors​

StatusCodeDescription
40079001Unsupported provider key (domain 79)
40310005The caller is not the platform owner (domain 2)

See Errors for the error format and common codes.