Integrations

import { listIntegrations } from "@arizeai/ax-client";

// Only agent integrations
const { data: agents, pagination } = await listIntegrations({
  type: "AGENT",       // optional; omit for all types
  space: "my-space",   // space name or ID (optional)
  name: "support",     // substring filter on integration name (optional)
  limit: 10,
});

// Every type, discriminated by `integration.type`
const { data: all } = await listIntegrations({});

import { createIntegration } from "@arizeai/ax-client";

// LLM integration
const llm = await createIntegration({
  type: "LLM",
  name: "Production OpenAI",
  config: { provider: "OPEN_AI", apiKey: "sk-..." },
});

// Agent integration
const agent = await createIntegration({
  type: "AGENT",
  name: "My Support Agent",
  config: {
    endpoint: "https://agent.example.com/replay",
    inputSchema: { type: "object", properties: { input: { type: "string" } } },
    requestPresets: [{ name: "default", config: { input: "hello" } }],
  },
});

import { getIntegration } from "@arizeai/ax-client";

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

// By name (requires type)
const integration = await getIntegration({
  integration: "Production OpenAI",
  type: "LLM",
  space: "my-space",  // optional filter when using a name
});

import { updateIntegration } from "@arizeai/ax-client";

// Rotate an LLM integration's API key by name (provider selects the config
// variant; it is immutable and must match the stored value)
const updated = await updateIntegration({
  integration: "Production OpenAI",
  type: "LLM",
  config: { provider: "OPEN_AI", apiKey: "sk-new-key" },
});

import { deleteIntegration } from "@arizeai/ax-client";

// By ID
await deleteIntegration({ integration: "your_integration_id" });

// By name (requires type)
await deleteIntegration({ integration: "Production OpenAI", type: "LLM" });