# Create organization

`POST /v1/organizations`, operation `organizations.CreateOrganization`

Creates an organization. The caller becomes its first member and owner.

## Request body

Content-Type: `application/json` (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `displayName` | `string` | No | Name shown in user interfaces. |
| `slug` | `string` | Yes | Globally unique, human-readable alias: 6 to 30 lowercase letters, digits or hyphens, starting with a letter. It never changes. |

## Responses

### 201

Created

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createTime` | `string (date-time)` | Yes | When the organization was created. |
| `displayName` | `string` | Yes | Name shown in user interfaces. |
| `name` | `string` | Yes | Resource name, organizations/{organization_id}. The ID is generated by the server and never changes. |
| `slug` | `string` | Yes | Globally unique, human-readable alias. It never changes, so that links to the organization keep working. |
| `state` | `string` | Yes | Lifecycle state. An organization whose deletion was requested is purged after a grace period unless it is undeleted. Values: `ACTIVE`, `DELETE_REQUESTED`. |
| `updateTime` | `string (date-time)` | Yes | When the organization was last updated. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.