AI Integrations

The ax ai-integrations commands are currently in ALPHA. The API may change without notice. A one-time warning is emitted on first use.

The ax ai-integrations commands let you create and manage LLM provider integrations on the Arize platform. AI integrations store provider credentials and configuration used by evaluators and other Arize features.

`ax ai-integrations list`

List AI integrations, optionally filtered by space.

ax ai-integrations list [--name <filter>] [--space <name_or_id>] [--limit <n>] [--cursor <cursor>] [--output <fmt>] [--verbose]

Option	Description
`--name`, `-n`	Case-insensitive substring filter on integration name
`--space`, `-s`	Filter integrations by space name or ID
`--limit`, `-l`	Maximum number of results to return (default: 15)
`--cursor`, `-c`	Pagination cursor for the next page
`--output`, `-o`	Output format (`table`, `json`, `csv`, `parquet`) or file path
`--verbose`, `-v`	Enable verbose logs

Examples:

ax ai-integrations list
ax ai-integrations list --space sp_abc123 --output integrations.json

`ax ai-integrations create`

Create a new AI integration.

ax ai-integrations create --name <name> --provider <provider> [options] [--output <fmt>] [--verbose]

Option	Description
`--name`, `-n`	Integration name (must be unique within the account) (required)
`--provider`	LLM provider: `OPEN_AI`, `AZURE_OPEN_AI`, `AWS_BEDROCK`, `VERTEX_AI`, `ANTHROPIC`, `CUSTOM`, `NVIDIA_NIM`, `GEMINI` (required)
`--api-key`	API key for the provider (write-only, never returned)
`--base-url`	Custom base URL for the provider
`--model-name`	Supported model name (repeat for multiple, e.g. `--model-name gpt-4o --model-name gpt-4o-mini`)
`--enable-default-models`	Enable the provider’s default model list (flag)
`--function-calling-enabled`	Enable function/tool calling (flag)
`--auth-type`	Authentication type: `DEFAULT`, `PROXY_WITH_HEADERS`, `BEARER_TOKEN`
`--headers`	Custom headers as a JSON object or path to a JSON file
`--provider-metadata`	Provider-specific metadata as a JSON object or path to a JSON file
`--output`, `-o`	Output format (`table`, `json`, `csv`, `parquet`) or file path
`--verbose`, `-v`	Enable verbose logs

Provider-specific requirements:

Provider	Required `--provider-metadata` fields
`AWS_BEDROCK`	`{"role_arn": "..."}`
`VERTEX_AI`	`{"project_id": "...", "location": "...", "project_access_label": "..."}`

Examples:

# OpenAI integration
ax ai-integrations create \
  --name "OpenAI Production" \
  --provider OPEN_AI \
  --api-key sk-... \
  --model-name gpt-4o \
  --model-name gpt-4o-mini \
  --enable-default-models

# AWS Bedrock integration
ax ai-integrations create \
  --name "Bedrock Production" \
  --provider AWS_BEDROCK \
  --provider-metadata '{"role_arn": "arn:aws:iam::123456789:role/BedrockRole"}'

`ax ai-integrations get`

Get an AI integration by name or ID.

ax ai-integrations get <name-or-id> [--space <name_or_id>] [--output <fmt>] [--verbose]

Option	Description
`--space`, `-s`	Space name or ID (required when using integration name instead of ID)
`--output`, `-o`	Output format (`table`, `json`, `csv`, `parquet`) or file path
`--verbose`, `-v`	Enable verbose logs

Examples:

ax ai-integrations get ai_abc123
ax ai-integrations get "My OpenAI Integration" --space my-space

`ax ai-integrations update`

Update an AI integration by name or ID. Only the fields you provide are updated. At least one option must be specified.

ax ai-integrations update <name-or-id> [--space <id>] [options] [--output <fmt>] [--verbose]

Option	Description
`--space`, `-s`	Space name or ID (required when using an integration name instead of ID)
`--name`, `-n`	Updated integration name
`--provider`	Updated LLM provider: `OPEN_AI`, `AZURE_OPEN_AI`, `AWS_BEDROCK`, `VERTEX_AI`, `ANTHROPIC`, `CUSTOM`, `NVIDIA_NIM`, `GEMINI`
`--api-key`	New API key (write-only)
`--base-url`	Updated custom base URL
`--model-name`	Supported model names (repeat for multiple; replaces existing list)
`--enable-default-models / --no-enable-default-models`	Enable or disable the provider’s default model list (omit to leave unchanged)
`--function-calling-enabled / --no-function-calling-enabled`	Enable or disable function calling (omit to leave unchanged)
`--auth-type`	Updated authentication type: `DEFAULT`, `PROXY_WITH_HEADERS`, `BEARER_TOKEN`
`--headers`	Custom headers as JSON or file path. Pass `'null'` to clear existing headers
`--provider-metadata`	Provider-specific metadata as JSON or file path. Pass `'null'` to clear
`--scopings`	Visibility scoping rules as a JSON array or file path (replaces all existing scopings)
`--output`, `-o`	Output format (`table`, `json`, `csv`, `parquet`) or file path
`--verbose`, `-v`	Enable verbose logs

Examples:

ax ai-integrations update ai_abc123 --name "OpenAI Staging"
ax ai-integrations update "Production OpenAI" --space sp_abc123 --api-key sk-new-key
ax ai-integrations update ai_abc123 --model-name gpt-4o --model-name gpt-4.1
ax ai-integrations update ai_abc123 --scopings '[{"space_id": "sp_abc"}]'

`ax ai-integrations delete`

Delete an AI integration. This operation is irreversible.

ax ai-integrations delete <name-or-id> [--space <id>] [--force] [--verbose]

Option	Description
`--space`, `-s`	Space name or ID (required when using an integration name instead of ID)
`--force`, `-f`	Skip the confirmation prompt
`--verbose`, `-v`	Enable verbose logs

Examples:

ax ai-integrations delete ai_abc123
ax ai-integrations delete "Production OpenAI" --space sp_abc123 --force

API reference

API clients

`ax ai-integrations list`

`ax ai-integrations create`

`ax ai-integrations get`

`ax ai-integrations update`

`ax ai-integrations delete`

​ax ai-integrations list

​ax ai-integrations create

​ax ai-integrations get

​ax ai-integrations update

​ax ai-integrations delete

`ax ai-integrations list`

`ax ai-integrations create`

`ax ai-integrations get`

`ax ai-integrations update`

`ax ai-integrations delete`