Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!
This is the documentation of the next version, still under development. See the latest release.

Create an organization

POST
/admin/users/{username}/orgs
curl --request POST \
--url https://gitea.com/api/v1/admin/users/example/orgs \
--header 'Authorization: Basic <credentials>' \
--header 'Content-Type: application/json' \
--data '{ "description": "example", "email": "example", "full_name": "example", "location": "example", "repo_admin_change_team_access": true, "username": "example", "visibility": "public", "website": "example" }'
username
required
string

Username of the user who will own the created organization

Media typeapplication/json

CreateOrgOption options for creating an organization

object
description

The description of the organization

string
email

The email address of the organization

string
full_name

The full display name of the organization

string
location

The location of the organization

string
repo_admin_change_team_access

Whether repository administrators can change team access

boolean
username
required

Username of the organization

string
visibility

Possible values are public (default), limited or private

string
Allowed values: public limited private
website

The website URL of the organization

string

Organization

Media typeapplication/json

Organization represents an organization

object
avatar_url

The URL of the organization’s avatar

string format: uri
description

The description of the organization

string
email

The email address of the organization

string
full_name

The full display name of the organization

string
id

The unique identifier of the organization

integer format: int64
location

The location of the organization

string
name

The name of the organization

string
repo_admin_change_team_access

Whether repository administrators can change team access

boolean
username

Username of the organization deprecated

string
visibility

The visibility level of the organization (public, limited, private)

string
Allowed values: public limited private
website

The website URL of the organization

string
Example
{
"visibility": "public"
}

APIForbiddenError is a forbidden error response

message
string
url
string

APIValidationError is error format response related to input validation

message
string
url
string