Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.scaling.cloud/llms.txt

Use this file to discover all available pages before exploring further.

You can manage your organization’s team members from the dashboard or via the API. All team management endpoints require an org:admin role.
Scaling has two roles:
  • org:admin — Full access to all settings, including inviting and removing members, managing roles, and configuring escalation policies and on-call schedules.
  • org:member — Can view and manage incidents but cannot access team or organization settings.
Every organization must have at least one admin.
1

Navigate to Team Members in the dashboard

In the Scaling dashboard, go to Settings → Team Members. From here you can see all current members, any pending invitations, and manage roles without using the API.To invite someone, click Invite member, enter their email address, choose a role, and send the invitation. They’ll receive an email with a link to join your organization.
2

Invite a member via the API

Send a POST request to /api/team/members/invite with the invitee’s email address and desired role.
curl -X POST https://api.scaling.cloud/v1/team/members/invite \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "emailAddress": "jane@example.com",
    "role": "org:member"
  }'
A successful response returns the invitation:
{
  "data": {
    "id": "inv_01jqm5x3k8vz9e2f4g7h",
    "emailAddress": "jane@example.com",
    "role": "org:member",
    "status": "pending",
    "createdAt": "2026-04-07T10:00:00.000Z"
  }
}
The invitee receives an email with a link to accept the invitation and join your organization. The invitation stays in pending status until they accept or you revoke it.
3

List members and pending invitations

Send a GET request to /api/team/members to see all current members and outstanding invitations in a single response.
curl https://api.scaling.cloud/v1/team/members \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "members": [
      {
        "id": "user_01jqm3xy4z5abc6de7fg",
        "email": "alice@example.com",
        "firstName": "Alice",
        "lastName": "Chen",
        "imageUrl": "https://example.com/avatars/alice.jpg",
        "role": "org:admin",
        "joinedAt": "2026-01-15T09:00:00.000Z"
      },
      {
        "id": "user_01jqm4ab2c3de5fg6hij",
        "email": "bob@example.com",
        "firstName": "Bob",
        "lastName": "Martinez",
        "imageUrl": null,
        "role": "org:member",
        "joinedAt": "2026-02-20T14:30:00.000Z"
      }
    ],
    "invitations": [
      {
        "id": "inv_01jqm5x3k8vz9e2f4g7h",
        "emailAddress": "jane@example.com",
        "role": "org:member",
        "status": "pending",
        "createdAt": "2026-04-07T10:00:00.000Z"
      }
    ]
  }
}
4

Update a member's role

Send a PATCH request to /api/team/members/{userId}/role to promote or demote a member. Replace {userId} with the member’s user ID from the list response.
curl -X PATCH https://api.scaling.cloud/v1/team/members/user_01jqm4ab2c3de5fg6hij/role \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "org:admin"
  }'
The response confirms the updated role:
{
  "data": {
    "id": "user_01jqm4ab2c3de5fg6hij",
    "role": "org:admin"
  }
}
Admins cannot change their own role or remove themselves from the organization. These actions must be performed by another admin. Attempting to do so returns a 400 error.
5

Revoke a pending invitation

If you need to cancel an invitation before it’s accepted, send a DELETE request to /api/team/members/invitations/{invitationId}. Replace {invitationId} with the ID from the invitation list.
curl -X DELETE https://api.scaling.cloud/v1/team/members/invitations/inv_01jqm5x3k8vz9e2f4g7h \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "success": true
  }
}
The invitation link in the invitee’s email will no longer work after revocation.
6

Remove a member

Send a DELETE request to /api/team/members/{userId} to remove an existing member from your organization. This immediately revokes their access.
curl -X DELETE https://api.scaling.cloud/v1/team/members/user_01jqm4ab2c3de5fg6hij \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": {
    "success": true
  }
}
The removed member will lose access to all incidents, schedules, and settings immediately. Their historical activity (such as incident status changes they made) is preserved.