> ## Documentation Index
> Fetch the complete documentation index at: https://arize-ax.mintlify.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Integrations

> Manage LLM provider credentials and configurations for use with evaluators and other Arize features.

<Note>
  The `ai_integrations` functions are currently in **ALPHA**. The API may change without notice. A one-time warning is emitted on first use.
</Note>

## List AI Integrations

```typescript theme={null}
import { listAiIntegrations } from "@arizeai/ax-client";

const { data: integrations, pagination } = await listAiIntegrations({
  space: "my-space",  // space name or ID (optional)
  name: "OpenAI",     // substring filter on integration name (optional)
  limit: 10,
});
```

## Create an AI Integration

```typescript theme={null}
import { createAiIntegration } from "@arizeai/ax-client";

const integration = await createAiIntegration({
  name: "Production OpenAI",
  provider: "openAI",
  apiKey: "sk-...",
  modelNames: ["gpt-4o", "gpt-4o-mini"],
  enableDefaultModels: true,
});
// Store the returned integrationId — use it when creating evaluators
```

### With Custom Headers (Proxy Auth)

```typescript theme={null}
import { createAiIntegration } from "@arizeai/ax-client";

const integration = await createAiIntegration({
  name: "Proxied OpenAI",
  provider: "openAI",
  authType: "proxy_with_headers",
  baseUrl: "https://your-proxy.example.com",
  headers: { "X-Custom-Header": "value" },
  modelNames: ["gpt-4o"],
  enableDefaultModels: false,
  functionCallingEnabled: true,
});
```

## Get an AI Integration

```typescript theme={null}
import { getAiIntegration } from "@arizeai/ax-client";

// By ID
const integration = await getAiIntegration({
  integration: "your_integration_id",
});

// By name (requires space)
const integration = await getAiIntegration({
  integration: "Production OpenAI",
  space: "my-space",
});
```

## Update an AI Integration

```typescript theme={null}
import { updateAiIntegration } from "@arizeai/ax-client";

const updated = await updateAiIntegration({
  integration: "your_integration_id",
  name: "Updated OpenAI",
  modelNames: ["gpt-4o"],
});
```

## Delete an AI Integration

```typescript theme={null}
import { deleteAiIntegration } from "@arizeai/ax-client";

await deleteAiIntegration({ integration: "your_integration_id" });
```