API Keys

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

const { data: apiKeys, pagination } = await listApiKeys({
  keyType: "USER",          // "USER" or "SERVICE" (optional)
  status: "ACTIVE",         // "ACTIVE" or "REVOKED" (optional)
  spaceId: "your_space",    // filter service keys by space (optional)
  userId: "your_user",      // filter by key creator (optional)
  limit: 10,
});

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

const apiKey = await createApiKey({
  name: "CI pipeline key",
  description: "Key for CI/CD pipeline",
  keyType: "USER",
});
// Store apiKey.key securely — it is only returned once

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

const serviceKey = await createApiKey({
  name: "service-key",
  keyType: "SERVICE",
  organizations: [
    {
      orgId: "T3JnMTIz",
      spaces: [
        { spaceId: "U3BhY2UxMjM", role: { name: "MEMBER" } },
        { spaceId: "U3BhY2U0NTY", role: { name: "READ_ONLY" } },
      ],
    },
  ],
  accountRole: { name: "MEMBER" },  // optional
  expiresAt: "2026-12-31T00:00:00Z",  // optional
});

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

await revokeApiKey({ apiKeyId: "your_api_key" });

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

const refreshed = await refreshApiKey({ apiKeyId: "your_api_key" });
// Store refreshed.key securely — it is only returned once

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

const refreshed = await refreshApiKey({
  apiKeyId: "your_api_key",
  expiresAt: "2027-12-31T00:00:00Z",
  gracePeriodSeconds: 3600,  // optional: old key remains valid for 1 hour
});