---
title: "Register an organization"
method: POST
path: "/organizations"
tags: ["organizations"]
---

# Register an organization

`POST /organizations`

Allow users to register an organization. The user will automatically leave their current organization.

## Request body

- RegisterOrganizationRequest
  - `name` string, required — The organization's name.

## Response `201`

Successfully registered the organization.

- RegisterOrganizationResponse
  - `id` string, uuid, required — The organization's ID.

## Other responses

- `400` — - [group:**request**, code:**0**]: Invalid field in the request body. - [group:**request**, code:**1**]: The request body is required.
- `409` — - [group:**organization**, code:**0**]: User already owns an organization.
- `500` — - [group:**organization**, code:**1000**]: Create organization encountered DB error. - [group:**organization**, code:**1001**]: Create organization grouping policy encountered error. - [group:**organization**, code:**1600**]: Delete organization grouping policy encountered error. - [group:**session**, code:**3**]: Failed to save session to cache.

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/versions/bcbab016469f/schema)