Inference Connections_create
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
manage_inferenceapplication/json- body
name*string1 <= length <= 255provider_type*ProviderTypeThe API a connection speaks. Each type sets its own base URL form and whether an API key is required.
"openai""anthropic"credential_mode?CredentialModeDefaults to shared_key. Fixed at create. A subscription connection takes no api_key, and its base_url is the provider's own API: https://api.anthropic.com for anthropic, https://chatgpt.com/backend-api/codex for openai.
"shared_key""subscription"base_url?stringThe provider's API base URL, in the form the provider's own SDK takes. Required for a shared_key connection; omit it for a subscription connection, which always uses its provider's own API. A URL that doesn't fit the provider type is refused with the expected form.
length <= 2048allowed_models*array<string>At least one entry: the models this connection may be used with. ["*"] allows all.
1 <= itemsapi_key?stringWrite-only, never returned in reads. Required for a shared_key connection; refused on a subscription one.
length <= 4096The request has succeeded and a new resource has been created as a result.
application/json- response
A credential + endpoint an org can use for inference.
id*uuiduuidname*string1 <= length <= 255provider_type*ProviderTypeThe API a connection speaks. Each type sets its own base URL form and whether an API key is required.
"openai""anthropic"credential_mode*CredentialModeHow a connection authenticates to its provider.
"shared_key""subscription"base_url?stringAbsent on a managed connection: the platform's endpoint is operator infrastructure, not the org's to see.
length <= 2048allowed_models*array<string>Models this connection may be bound to. ["*"] allows all.
has_api_key?booleanRead-only: whether an API key is stored. The key itself is never returned. Absent on a managed connection, whose credential the org neither sets nor fixes.
managed*booleanRead-only: true for the platform-provided connection, which the org can't edit or delete.
created_at?stringAbsent on a managed connection.
date-timeupdated_at?stringAbsent on a managed connection.
date-timecurl -X POST 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/inference/connections' \ -H 'Content-Type: application/json' \ -d '{ "name": "string", "provider_type": "openai", "allowed_models": [ "string" ]}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "provider_type": "openai", "credential_mode": "shared_key", "base_url": "string", "allowed_models": [ "string" ], "has_api_key": true, "managed": true, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}