Create an organization

POST

/api/orgs

curl --request POST \
  --url https://api-dev.wrktr.com/api/orgs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "slug": "example", "name": "example" }'

You become its owner. slug is its name in URLs and on the CLI.

Authorizations

• bearer

Request Body^required

Media typeapplication/json

object

slug

required

string

name

required

string

<= 100 characters

Example^generated

{
  "slug": "example",
  "name": "example"
}

Responses

200

OrgInfo

Media typeapplication/json

object

slug

required

string

name

required

string

personal

required

boolean

role

required

string

Allowed values: owner member

Example

{
  "role": "owner"
}

401

Unauthorized

Media typeapplication/json

object

_tag

required

string

Allowed values: Unauthorized

message

required

string

Example

{
  "_tag": "Unauthorized"
}

409

SlugTaken

Media typeapplication/json

object

_tag

required

string

Allowed values: SlugTaken

slug

required

string

Example

{
  "_tag": "SlugTaken"
}

422

InvalidInput

Media typeapplication/json

object

_tag

required

string

Allowed values: InvalidInput

message

required

string

Example

{
  "_tag": "InvalidInput"
}