Skip to main content
POST
/
organizations
Create organization
curl --request POST \
  --url https://api.diversion.dev/v0/organizations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Example Organization"
}
'
{
  "id": "org_123456",
  "name": "Example Organization",
  "owner_id": "user_123456",
  "total_storage": 1000000,
  "description": "This is an example organization.",
  "members": [
    {
      "id": "member_123456",
      "user_id": "user_123456",
      "organization_id": "org_123456",
      "role": "READ"
    }
  ],
  "invites": [
    {
      "id": 123456,
      "organization_id": "org_123456",
      "organization_name": "Great Organization",
      "inviting_user_id": "user_123456",
      "inviting_user_name": "John Doe",
      "invited_email": "[email protected]",
      "role": "READ",
      "status": "PENDING",
      "created": "2023-01-01T00:00:00Z",
      "expires": "2023-01-31T00:00:00Z"
    }
  ],
  "in_warning_group": true
}

Authorizations

​
Authorization
string
header
required

This API uses OAuth 2 with the implicit grant flow

Body

application/json
​
name
string
required
Required string length: 1 - 128
Example:

"Example Organization"

Response

Organization created

​
id
string
required

Unique identifier for the organization

Example:

"org_123456"

​
name
string
required

Name of the organization

Example:

"Example Organization"

​
owner_id
string
required

ID of the user who owns the organization

Example:

"user_123456"

​
total_storage
integer
required

Total storage allocated to the organization

Example:

1000000

​
description
string

Description of the organization

Example:

"This is an example organization."

​
members
object[]

List of members in the organization

​
invites
object[]

List of invites sent by the organization

​
in_warning_group
boolean

Whether the organization is in the warning group

Example:

true