Skip to content
Try Gitea Cloud ☁️ for 30 days → Accelerate your Development & Deploys!

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 public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

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) public UserVisibilityPublic limited UserVisibilityLimited private UserVisibilityPrivate

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