Create an organization

POST

/api/v4/organizations

• GitLab REST API

Creates an organization. This feature was introduced in GitLab 17.5. This feature is behind the allow_organization_creation feature flag. In GitLab 18.3, the feature flag changed to organization_switching.

Authorizations

• http
• oauth2

Request Body ^required

Media type multipart/form-data

object

name

required

The name of the organization

string

nullable

path

required

The path of the organization

string

nullable

description

The description of the organization

string

nullable

visibility

The visibility level of the organization

string

nullable

Allowed values: private public

avatar

The avatar image for the organization

string format: binary

nullable

Responses

201

Created

Media type application/json

object

id

integer format: int64

uuid

string

name

string

path

string

description

string

visibility

string

created_at

string format: date-time

updated_at

string format: date-time

web_url

string

avatar_url

string

Example

{
  "id": 1,
  "uuid": "0192f8c2-1a2b-7cde-89ab-0123456789ab",
  "name": "GitLab",
  "path": "gitlab",
  "description": "My description",
  "visibility": "public",
  "created_at": "2022-02-24T20:22:30.097Z",
  "updated_at": "2022-02-24T20:22:30.097Z",
  "web_url": "https://example.com/o/gitlab/-/overview",
  "avatar_url": "https://example.com/uploads/-/system/organizations/organization_detail/avatar/1/avatar.png"
}

400

Bad Request