> ## 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.

# Organizations

> Create and manage organizations within your Arize AX account using the TypeScript SDK.

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

## List Organizations

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

const { data: organizations, pagination } = await listOrganizations({
  name: "platform",  // optional substring filter on organization name
  limit: 10,
});
```

## Create an Organization

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

const org = await createOrganization({
  name: "my-organization",
  description: "Organization for the platform engineering team",  // optional
});
console.log(org.id);
```

## Get an Organization

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

// By ID
const org = await getOrganization({ organization: "org_12345" });

// By name
const org = await getOrganization({ organization: "my-organization" });
console.log(org);
```

## Update an Organization

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

const org = await updateOrganization({
  organization: "my-organization",  // organization name or ID
  name: "my-organization-renamed",  // optional
  description: "Updated description",  // optional
});
console.log(org);
```

## Delete an Organization

<Warning>
  This operation is irreversible. It deletes the organization and all
  resources that belong to it, including all spaces and their contents
  (projects, experiments, evaluators, models, monitors, dashboards,
  datasets, annotation configs, annotation queues, custom metrics) as
  well as organization-level resources (integrations, cost
  configurations, SAML identity providers, and API keys).
</Warning>

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

await deleteOrganization({ organization: "my-organization" });
```

## Add a User to an Organization

Uses upsert semantics — if the user is already a member, their role is updated. Requires organization admin role.

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

const membership = await addOrganizationUser({
  organizationId: "your_organization_id",
  userId: "your_user_id",
  role: { type: "predefined", name: "member" },
});
```

## Remove a User from an Organization

Removes the user from the organization and all its child spaces (membership cascade). Requires organization admin role.

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

await removeOrganizationUser({
  organizationId: "your_organization_id",
  userId: "your_user_id",
});
```