Organizations

Xentree supports multi-tenant organization management for collaborative workspaces.

What you can do

create and manage organizations

assign roles to members

invite or remove users

structure collaboration across teams

Authentication and scopes

Organizations endpoints support both bearer and API key auth.

Recommended API key scopes:

organizations:read for listing organizations and members

organizations:write for create/update/delete and membership changes

Main endpoints

POST /api/organizations

GET /api/organizations

GET /api/organizations/{org_id}

PATCH /api/organizations/{org_id}

DELETE /api/organizations/{org_id}

Members

GET /api/organizations/{org_id}/members

POST /api/organizations/{org_id}/members

PATCH /api/organizations/{org_id}/members/{target_user_id}

PUT /api/organizations/{org_id}/members/{target_user_id}

DELETE /api/organizations/{org_id}/members/{target_user_id}

Tenants (admin)

GET /api/admin/tenants

Role model

Representative roles include:

administrator

billing_manager

team_manager

member

Example create organization request

{
  "name": "Acme Learning",
  "slug": "acme-learning",
  "description": "Workspace for team learning and collaboration"
}

Access model

Most organization endpoints require an authenticated user, and privileged actions require the appropriate organization role.

When using API keys, role and tenancy checks still apply after scope checks.

Organizations

What you can do#

Authentication and scopes#

Main endpoints#

Organizations#

Members#

Tenants (admin)#

Role model#

Example create organization request#

Access model#

What you can do

Authentication and scopes

Main endpoints

Organizations

Members

Tenants (admin)

Role model

Example create organization request

Access model