Organization

A Distributed Cloud AIP organization is comprised of the unique combination of your Agents, monitored infrastructure, and users.

Each organization must have at least one Owner, but can have many members with different roles, including Users, Readers, and additional Owners. For more information about roles in Distributed Cloud AIP, see Account Roles.

The organization endpoints help you view a list of organization members, invite new or existing Distributed Cloud AIP users to your organization, and remove users from your organization.

List Current Members of an Organization

Overview

This method enables you to get a list of all of the members of your organization.

Sample Queries

Find all of the members of your your organization:

https://api.threatstack.com/v2/organizations/members

Find only the enabled members of an organization:

https://api.threatstack.com/v2/organizations/members?enabledOnly=true
Request
query Parameters
enabledOnly
string

Limits response to organization members that are currently enabled

Responses
200

OK

400

Bad parameters

401

Unauthorized response

403

The user is not allowed to perform this action

404

The resource was not found

429

Rate limit hit

500

An internal error has occurred

get/organizations/<orgId>/members
Response samples
application/json
{
  • "id": "string",
  • "displayName": "string",
  • "email": "string",
  • "lastAuthenticatedAt": "string",
  • "role": "string",
  • "ssoEnabled": true,
  • "mfaEnabled": true,
  • "userEnabled": true
}

Add an Existing User to an Organization

Overview

This method enables you add an existing user to an existing organization.

NOTE

  • Accounts with the Owner role for this organization can assign new users any role (Owner, User, or Reader).
  • Accounts with the User role for this organization can assign new users the User or Reader role
  • For more information about roles in Distributed Cloud AIP, see Account Roles.

Sample Query

Add an existing user to your existing organization:

https://api.threatstack.com/v2/organizations/members
Request
Request Body schema: application/json
id
required
string

The unique Distributed Cloud AIP identifier for a Distributed Cloud AIP user account

role
string

The role assigned to the user account in the organization

Enum: "owner" "user" "reader"
Responses
200

OK

400

Bad parameters

401

Unauthorized response

403

The user is not allowed to perform this action

404

The resource was not found

429

Rate limit hit

500

An internal error has occurred

post/organizations/members
Request samples
application/json
{
  • "id": "string",
  • "role": "owner"
}
Response samples
application/json
{
  • "id": "string",
  • "displayName": "string",
  • "email": "string",
  • "lastAuthenticatedAt": "string",
  • "role": "string",
  • "ssoEnabled": true,
  • "mfaEnabled": true,
  • "userEnabled": true
}

Revoke a User's Membership from an Organization

Overview

This method allows you to remove a user from an organization.

NOTE

  • Only users with the Owner role can use this endpoint. For more information about roles in Distributed Cloud AIP, see Account Roles.

Sample Query

Remove a user from your organization:

https://api.threatstack.com/v2/organizations/members/{userId}
Request
path Parameters
userId
required
string

The unique identifier of the Distributed Cloud AIP user account to remove

Responses
204

No content

400

Bad parameters

401

Unauthorized response

403

The user is not allowed to perform this action

404

The resource was not found

429

Rate limit hit

500

An internal error has occurred

delete/organizations/members/{userId}
Response samples
application/json
{
  • "message": "string"
}

Invite a New User to an Existing Organization

Overview

This method allows you to add a new Distributed Cloud AIP user to an existing organization.

NOTE

  • Accounts with the Owner role for this organization can assign new users any role (Owner, User, or Reader).
  • Accounts with the User role for this organization can assign new users the User or Reader role
  • For more information about roles in Distributed Cloud AIP, see Account Roles.

Sample Query

Invite a new Distributed Cloud AIP user to your organization:

https://api.threatstack.com/v2/organizations/invites
Request
Request Body schema: application/json
email
required
string

The email address of the user you want to invite to join the organization

role
string

The role assigned to the user account in the organization

Enum: "owner" "user" "reader"
Responses
200

OK

400

Bad parameters

401

Unauthorized response

403

The user is not allowed to perform this action

404

The resource was not found

429

Rate limit hit

500

An internal error has occurred

post/organizations/invites
Request samples
application/json
{
  • "email": "string",
  • "role": "owner"
}
Response samples
application/json
{
  • "sentToEmail": "string",
  • "status": "string",
  • "role": "owner"
}