---
title: "client.organizations"
description: ""
section: "Libraries"
group: "SDK resources"
order: 206
---

Accessed via `client.organizations`.

## Methods

### `create`

Create an organization.

```ts
create(params: CreateOrganizationParams): Promise<Organization>
```

**Types:** [CreateOrganizationParams](/types/create-organization-params) · [Organization](/types/organization)

### `delete`

Soft-delete an organization.

```ts
delete(params: DeleteOrganizationParams): Promise<SuccessResponse>
```

**Types:** [DeleteOrganizationParams](/types/delete-organization-params) · [SuccessResponse](/types/success-response)

### `list`

List organizations.

```ts
list(params?: Omit<ListOrganizationsParams, "filter" | "orderBy"> & { filter?: OrganizationFilter; orderBy?: OrganizationOrderBy[]; } & OrganizationShorthands): Promise<Page<Organization>>
```

**Types:** [ListOrganizationsParams](/types/list-organizations-params) · [OrganizationFilter](/types/organization-filter) · [OrganizationOrderBy](/types/organization-order-by) · [OrganizationShorthands](/types/organization-shorthands) · [Page](/types/page) · [Organization](/types/organization)

### `purge`

Permanently delete a soft-deleted organization.

```ts
purge(params: PurgeOrganizationParams): Promise<SuccessResponse>
```

**Types:** [PurgeOrganizationParams](/types/purge-organization-params) · [SuccessResponse](/types/success-response)

### `restore`

Restore a soft-deleted organization.

```ts
restore(params: RestoreOrganizationParams): Promise<Organization>
```

**Types:** [RestoreOrganizationParams](/types/restore-organization-params) · [Organization](/types/organization)

### `retrieve`

Get an organization by ID.

```ts
retrieve(params: RetrieveOrganizationParams): Promise<Organization>
```

**Types:** [RetrieveOrganizationParams](/types/retrieve-organization-params) · [Organization](/types/organization)

### `retrieveByHandle`

Fetch an organization by handle. `GET /api/organizations/by-handle/:handle`

```ts
retrieveByHandle(params: { handle: string }): Promise<Organization>
```

**Types:** [Organization](/types/organization)

### `update`

Update an organization.

```ts
update(params: UpdateOrganizationParams): Promise<Organization>
```

**Types:** [UpdateOrganizationParams](/types/update-organization-params) · [Organization](/types/organization)