Skip to main content
An organization is the top of the resource hierarchy — it owns environments, tenants, billing, and the people who work in it. Organization administration is a dashboard operation, so every endpoint here requires a user session.
All endpoints on this page are [User] — they require a signed-in user session and are not available to API keys. See Authentication.

​
Roles

Members hold one role per organization, which determines what they can do: See Members & roles for the full permission matrix.

​
Endpoints

​
List organizations

GET /organizations Returns every organization the signed-in user belongs to, each with the user’s role in it.

​
Get an organization

GET /organizations/:id
​
string
required
The organization ID.

​
Create an organization

POST /organizations Creates an organization and auto-provisions a default environment, a default tenant inside it, and a starting credit balance — so you can begin working immediately.
​
string
required
Display name for the organization.
​
string
required
Unique URL-safe slug using lowercase letters, numbers, and hyphens.
​
string
business or personal. Defaults to business.
The creator becomes the owner. AutoSage also provisions a default environment, tenant, and starting credits; use Current caller to discover those resource IDs.

​
Update an organization

PATCH /organizations/:id Updates the organization’s name or status. Requires an administrative role.
​
string
required
The organization ID.
​
string
New display name.
​
string
New status — active, inactive, or suspended.
Only administrative roles (owner, billing_admin) may update an organization.

​
Delete an organization

DELETE /organizations/:id Permanently deletes the organization and everything under it.
​
string
required
The organization ID.
Only the owner may delete an organization. This is irreversible and removes all environments, tenants, and content.

​
List members

GET /organizations/:id/members Returns the organization’s active members (with their roles) and any pending invitations.
​
string
required
The organization ID.

​
Invite a member

POST /organizations/:id/members Sends an invitation to an email address with an assigned role. The invitee accepts through the invites flow.
​
string
required
The organization ID.
​
string
required
Email address to invite.
​
string
Role to grant on acceptance — billing_admin, developer, or viewer. Defaults to viewer; ownership is assigned separately after the user joins.
Only the owner may invite members. Invitations expire after 7 days — see Invites.

​
Assign a role

POST /organizations/:id/members/role Changes an existing member’s role.
​
string
required
The organization ID.
​
string
required
The member’s user ID.
​
string
required
The new role — one of owner, billing_admin, developer, viewer.
Only the owner may change member roles.

​
Remove a member

DELETE /organizations/:id/members/:member_id Removes a member from the organization, revoking their access immediately.
​
string
required
The organization ID.
​
string
required
The member’s user ID.
Only the owner may remove members.

​
Revoke an invite

DELETE /organizations/:id/invites/:invite_id Cancels a pending invitation before it is accepted.
​
string
required
The organization ID.
​
string
required
The pending invitation ID.
Only the owner may revoke invitations.

​
Next steps

Members & roles

Understand exactly what each role can do.

Environments

Add environments to isolate dev, staging, and production.

Invites

See how invitees accept and join.