GIgitlab
organizations

Create an organization

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.

post/api/v4/organizations

Request

  • Base URL
    https://gitlab.com
  • Auth
    none declared

Request body

namestring required

The name of the organization

pathstring required

The path of the organization

descriptionstring

The description of the organization

visibility'private' | 'public'

The visibility level of the organization

avatarstring binary

The avatar image for the organization

Response

Create an organization

idinteger required
uuidstring required
namestring required
pathstring required
descriptionstring required
visibilitystring required
created_atstring date-time required
updated_atstring date-time required
web_urlstring required
avatar_urlstring required

Example response

{
  "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"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.