Get organization details

Retrieves detailed information about a specific organization including:

• Name
• Description
• Owner ID
• Total storage usage
• Warning group status

Requirements: Requires READ access to the organization (user must be a member).

Returns:

• 404 Not Found if the organization doesn’t exist or user lacks access

GET /organizations/{org_id}

Get organization details

cURL

curl --request GET \
  --url https://api.diversion.dev/v0/organizations/{org_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "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"
    }
  ],
  "invites": [
    {
      "id": 123456,
      "organization_id": "org_123456",
      "organization_name": "Great Organization",
      "inviting_user_id": "user_123456",
      "inviting_user_name": "John Doe",
      "invited_email": "[e-mail]",
      "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

Path Parameters

org_id · string · required

An ID of an organization

Response

200

application/json

Organization details returned

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

Show child attributes

invites · object[]

List of invites sent by the organization

Show child attributes

in_warning_group · boolean

Whether the organization is in the warning group

Example:

true