curl --request GET \
--url https://api.diversion.dev/v0/organizations \
--header 'Authorization: Bearer <token>'{
"object": "Organization",
"items": [
{
"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
}
]
}Lists all organizations the user is a member of, optionally filtered to show only owned organizations when owned=true. Results are sorted alphabetically by organization name. Each organization includes basic metadata and a flag indicating if it’s in a warning group (quota breach or payment issue). Returns an empty list if the user is not a member of any organizations.
curl --request GET \
--url https://api.diversion.dev/v0/organizations \
--header 'Authorization: Bearer <token>'{
"object": "Organization",
"items": [
{
"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
}
]
}This API uses OAuth 2 with the implicit grant flow
Filter by organizations owned by the user or not.
Success
Organization Show child attributes
Unique identifier for the organization
"org_123456"
Name of the organization
"Example Organization"
ID of the user who owns the organization
"user_123456"
Total storage allocated to the organization
1000000
Description of the organization
"This is an example organization."
List of members in the organization
Show child attributes
Unique identifier for the organization member
"member_123456"
ID of the user who is a member of the organization
"user_123456"
ID of the organization
"org_123456"
READ, WRITE, ADMIN, OWNER List of invites sent by the organization
Show child attributes
Unique identifier for the organization invite
123456
ID of the organization
"org_123456"
Name of the organization
"Great Organization"
ID of the user who is inviting to the organization
"user_123456"
Name of the user who is inviting to the organization
"John Doe"
Email of the user who is invited to the organization
READ, WRITE, ADMIN, OWNER PENDING, ACCEPTED, REJECTED, CANCELED Date and time when the invite was created
"2023-01-01T00:00:00Z"
Date and time when the invite expires
"2023-01-31T00:00:00Z"
Whether the organization is in the warning group
true