Authorizations
Enter your JWT in the format: Bearer {token}
Path Parameters
The ID of the workspace.
Example:
"ws_a1b2c3d4e5f6g7h8"
Our documentation site will be down for a migration until 31 Oct 2025. Please check back next week!
curl --request GET \
--url https://api.altostrat.io/workspaces/{workspaceId}/organizations \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "org_aBcDeFg123456789",
"name": "Engineering Department",
"workspace_id": "ws_a1b2c3d4e5f6g7h8",
"external_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"parent_org_id": "org_zYxWvUt987654321",
"path": "org_root123#org_parent456",
"depth": 2,
"billing_account_id": "cus_a1b2c3d4e5f6g7h8",
"picture": "https://cdn.altostrat.io/logos/engineering.png",
"usage": {
"usage": {
"locations": 2,
"users": 5
},
"subtree_usage": {
"locations": 10,
"users": 25
}
},
"limits": {
"locations": 10,
"users": 50
},
"branding": {
"display_name": "ACME Corp",
"login_hint": "acme-corp",
"colors": {
"primary": "#FF5733",
"page_background": "#FFFFFF"
}
}
}
],
"has_more": false
}Returns a list of all organizations within the specified workspace.
curl --request GET \
--url https://api.altostrat.io/workspaces/{workspaceId}/organizations \
--header 'Authorization: Bearer <token>'{
"data": [
{
"id": "org_aBcDeFg123456789",
"name": "Engineering Department",
"workspace_id": "ws_a1b2c3d4e5f6g7h8",
"external_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
"parent_org_id": "org_zYxWvUt987654321",
"path": "org_root123#org_parent456",
"depth": 2,
"billing_account_id": "cus_a1b2c3d4e5f6g7h8",
"picture": "https://cdn.altostrat.io/logos/engineering.png",
"usage": {
"usage": {
"locations": 2,
"users": 5
},
"subtree_usage": {
"locations": 10,
"users": 25
}
},
"limits": {
"locations": 10,
"users": 50
},
"branding": {
"display_name": "ACME Corp",
"login_hint": "acme-corp",
"colors": {
"primary": "#FF5733",
"page_background": "#FFFFFF"
}
}
}
],
"has_more": false
}Enter your JWT in the format: Bearer {token}
The ID of the workspace.
"ws_a1b2c3d4e5f6g7h8"
Was this page helpful?