v1

latestOpenAPI 3.0.32026-07-22115106141.4 KB

Organization Management

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}

Response

Organization details returned

idstring required

Unique identifier for the organization

namestring required

Name of the organization

descriptionstring

Description of the organization

owner_idstring required

ID of the user who owns the organization

total_storageinteger required

Total storage allocated to the organization

in_warning_groupboolean

Whether the organization is in the warning group

Example response

{
  "id": "org_123456",
  "name": "Example Organization",
  "description": "This is an example organization.",
  "owner_id": "user_123456",
  "total_storage": 1000000,
  "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": "john.doe@example.com",
      "created": "2023-01-01T00:00:00Z",
      "expires": "2023-01-31T00:00:00Z"
    }
  ],
  "in_warning_group": true
}