Create Organization

Any authenticated non-Viewer may create an organization — org creation is a self-service action independent of the global RBAC role otherwise, mirroring Gogs/GitHub, but Viewer is excluded like every other org management action. The creator automatically becomes that org's first admin member.

Authorization

HTTPBearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*Name

Length1 <= length <= 255

full_name?string|null

description?string|null

website?string|null

location_id?|null

email?string|null

phone?string|null

private?Private

Defaultfalse

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/organizations" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "name": "string",  "private": true,  "is_active": true,  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "full_name": "string",  "description": "string",  "website": "string",  "location_id": "46910cc3-ab41-4b80-b4a7-94dab9f1b795",  "location_name": "string",  "email": "string",  "phone": "string",  "logo_file_id": "8a606be6-cb8e-4c20-bcd3-4ef40c89ea63",  "logo_url": "string",  "asset_count": 0,  "member_count": 0,  "is_member": false,  "my_role": "member",  "can_manage": false,  "is_last_admin": false,  "has_pending_join_request": false}

{  "detail": [    {      "loc": [        "string"      ],      "msg": "string",      "type": "string"    }  ]}

Authorization

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`