admin

Create an organization

Changed on Oct 28, 2026

post/admin/users/{username}/orgs

Request

Base URL
https://demo.gitea.com/api/v1
Auth
- HTTP basic
- or API key in query parameter token
- or API key in query parameter access_token
- or API key in header Authorization
- or API key in query parameter sudo
- or API key in header Sudo
- or API key in header X-GITEA-OTP
TypeScript
https://skmtc.dev/gitea/apis/gitea-api/docs/admin/users/:username/orgs/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

usernamestring required

username of the user who will own the created organization

Request body

descriptionstring

The description of the organization

emailstring

The email address of the organization

full_namestring

The full display name of the organization

locationstring

The location of the organization

repo_admin_change_team_accessboolean

Whether repository administrators can change team access

usernamestring required

username of the organization

visibility'public' | 'limited' | 'private'

possible values are public (default), limited or private

websitestring

The website URL of the organization

Response

Organization

avatar_urlstring

The URL of the organization's avatar

descriptionstring

The description of the organization

emailstring

The email address of the organization

full_namestring

The full display name of the organization

idinteger

The unique identifier of the organization

locationstring

The location of the organization

namestring

The name of the organization

repo_admin_change_team_accessboolean

Whether repository administrators can change team access

usernamestring

username of the organization deprecated

visibility'public' | 'limited' | 'private'

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