Administration Organizations

Administration Organizations

Create a new organization

POST /admin/users/:username/orgs

Parameters

Name	Type	Description
username	string	Required Organization user name
full_name	string	Full name of organization
description	string	Description to the organization
website	string	Official website
location	string	Organization location

Example

{
  "username": "gogs2",
  "full_name": "Gogs2",
  "description": "Gogs(Go Git Service) is a painless self-hosted Git Service.",
  "website": "https://gogs.io",
  "location": "USA"
}

Response

Status: 201 Created
Content-Type: application/json

{
  "id": 7,
  "username": "gogs2",
  "full_name": "Gogs2",
  "avatar_url": "/avatars/7",
  "description": "Gogs(Go Git Service) is a painless self-hosted Git Service.",
  "website": "https://gogs.io",
  "location": "USA"
}

Create team of an organization

POST /admin/orgs/:orgname/teams

Parameters

Name	Type	Description
name	string	Required Team name
description	string	Description to the team
permission	string	Team permission, can be read, write or admin, default is read

Example

{
  "name": "new-team",
  "description": "A new team created by API",
  "permission": "write"
}

Response

Status: 201 Created
Content-Type: application/json

{
  "id": 12,
  "name": "new-team",
  "description": "A new team created by API",
  "permission": "write"
}

Add team membership

PUT /admin/orgs/:orgname/teams/:teamid/memberships/:username

Response

Status: 204 No Content

Remove team membership

DELETE /admin/orgs/:orgname/teams/:teamid/memberships/:username

Response

Status: 204 No Content