AI Providers

Create an AI provider

Creates a new LLM provider configuration.

A bedrock or vertex record must carry a credential of its own — a linked secret_id, or an apiKey in config. Without one the provider SDK signs with the server's own credentials (the AWS default credential chain, Google Application Default Credentials), which is refused with 400 VALIDATION_FAILED unless the deployment allows it.

post/v1/projects/{project_id}/ai-providers

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/ai-providers
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Request body

namestring required

Provider configuration name

provider'openai' | 'anthropic' | 'google' | 'xai' | 'groq' | 'ollama' | 'azure' | 'bedrock' | 'vertex' | 'gateway' | 'custom' | 'naturali' required

LLM provider

default_modelstring required

Default model to use

secret_idstring

Secret ID containing API credentials. Required for bedrock and vertex unless config.apiKey carries one.

base_urlstring

Custom base URL for the provider

configobject

Additional provider-specific configuration

Example request

{
  "name": "OpenAI Production",
  "provider": "openai",
  "default_model": "gpt-4",
  "secret_id": "sec_V1StGXR8Z5jdHi6B"
}

Response

AI provider created successfully

idstring
namestring
providerstring
default_modelstring
project_idstring
created_atstring date-time
updated_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.