The following article covers Sigma’s developer API for organization teams.

Summary of Content

Endpoints
The Team Object
      Attributes
List all Teams
Look up a Team
Create a New Team
Update an Existing Team
Update Team Members
Delete a Team
Related Resources

Endpoints

GET /v2/teams

      Returns a list of teams in your organization. Learn more
      Try it in Swagger

GET /v2/teams/{teamId}

      Returns a team object based on its unique identifier, teamId. Learn more

      Try it in Swagger

POST /v2/teams

      Creates a new team, and returns a team object.
      Learn more

      Try it in Swagger

PATCH /v2/teams/{teamId}

      Updates the team's metadata and returns the associated team object.
      Learn more

      Try it in Swagger

PATCH /v2/teams/{teamId}/members

      Adds or removes team members, based on the entered parameters. Returns an empty object. Learn more

      Try it in Swagger

DELETE /v2/teams/{teamId}

      Deletes a team based on the provided unique identifier, teamId. Returns an empty object. Learn more

      Try it in Swagger

The Team Object

Attributes

teamId string

The team’s unique identifier

name string

The team name

description string | null

A description of the team

createdBy string

The unique identifier, memberId, of the organization member who created the team

updatedBy string

The unique identifier, memberId, of the organization member who last made changes to the team

createdAt string

The timestamp at which the team was created

updatedAt string

The timestamp at which the team was last updated

isArchived boolean

True if the team is archived

members Array<memberId>

A list of unique identifiers (memberId) for all organization members assigned to the team

Important: This attribute is only included when the request is for a single team: GET /v2/teams/{teamId}. It is not included in responses to GET /v2/teams.

{
    "teamId": "88858466-5299-4425-95c0-4b7d93268bae",
    "name": "Sales US–West",
    "description": "All Sales employees in the Western US region.",
    "createdBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "updatedBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "createdAt": "2021-10-07T19:43:01.778Z",
    "updatedAt": "2021-10-07T19:43:01.778Z",
"members": [
"6VZszXPJqLXpIezcD5adESnwfPPUg",
"7xtVWXPJqLptLezceRadESnwfttOP"
]
}

 

List all Teams

Returns a list of teams in your organization.

GET /v2/teams

Try it in Swagger

 

Permissions 

  • The user account associated with the API access token must be a member of a team to view its details. Organization Admins have access to all teams.
    Note: If you encounter a permission error for the given endpoint, check with your organization Admin to verify your account type and permissions associated with your API token.

Parameters

None

cURL Request

curl --location --request GET 'https://api.sigmacomputing.com/v2/teams \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \

 

Response

Returns Array<Team>.

Array<{
    "teamId": string,
    "createdBy": string,
    "updatedBy": string,
    "createdAt": string,
    "updatedAt": string,
    "name": string,
    "description": string | null
}>

 

Example

Example Request:

curl --location --request GET 'https://api.sigmacomputing.com/v2/teams' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \

 

Example Response:

[
 {
    "teamId": "22340501-5fda-4000-8000-000000000001",
    "createdBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "updatedBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "createdAt": "2021-10-04T20:36:40.591Z",
    "updatedAt": "2021-10-04T20:36:40.591Z",
    "name": "All Members",
   "description": null
 },
 {
    "teamId": "88858466-5299-4425-95c0-4b7d93268bae",
    "createdBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "updatedBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "createdAt": "2021-10-07T19:43:01.778Z",
    "updatedAt": "2021-10-07T19:43:01.778Z",
    "name": "Sales US–West",
    "description": "All Sales employees in the  Western US region."
 }
]

 

Look up a Team

Returns a team object based on its unique identifier, teamId.

GET /v2/teams/{teamId}

Try it in Swagger

Permissions 

  • The user account associated with the API access token must be a member of the requested team. Organization Admins have access to all teams.
    Note: If you encounter a permission error for the given endpoint, check with your organization Admin to verify your account type and permissions associated with your API token.

Parameters

None 

cURL Request

curl --location --request GET 'https://api.sigmacomputing.com/v2/teams/{teamId} \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \

 

Response

Returns a team object.

{
    "teamId": string,
    "createdBy": string,
    "updatedBy": string,
    "createdAt": string,
    "updatedAt": string,
    "name": string,
    "description": string | null,
"isArchived": boolean,
"members": Array<string>
}


Example

Example Request:

curl --location --request GET 'https://api.sigmacomputing.com/v2/teams/22340501-5fda-4000-8000-000000000001' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \


Example Response:

{
    "teamId": "22340501-5fda-4000-8000-000000000001",
    "createdBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "updatedBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "createdAt": "2021-10-04T20:36:40.591Z",
    "updatedAt": "2021-10-04T20:36:40.591Z",
    "name": "All Members",
   "description": null,
"isArchived": false,
"members": [
"6VZszXPJqLXpIezcD5adESnwfPPUg",
"7xtVWXPJqLptLezceRadESnwfttOP"
]
}

 

Create a New Team

Creates a new team. Returns a team object.

POST /v2/teams

Try it in Swagger

Permissions

  • The user account associated with the API access token must have permission to create teams. Only Admins have this level of permission.
    Note: If you encounter a permission error for the given endpoint, check the permissions associated with your API token.

Parameters

name string

The name to be assigned to the new team.

description string [optional]

A description for the team.

members Array<memberId> [optional]

A list of organization members to assign to the team.

createTeamFolder boolean [optional]

If true, a team workspace is created. The team will automatically be granted CanContribute access to this workspace.

cURL Request

curl --location --request POST 'https://api.sigmacomputing.com/v2/teams/ \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"name": string,
   "description": string, // or undefined
  "members": Array<memberId>, // or undefined
"createTeamFolder": boolean // or undefined
}'

 

Response

Returns a team object.

{
    "teamId": string,
    "createdBy": string,
    "updatedBy": string,
    "createdAt": string,
    "updatedAt": string,
    "name": string,
    "description": string | null,
"isArchived": boolean,
"members": Array<string>
}

 

Example

Example Request:

curl --location --request POST 'https://api.sigmacomputing.com/v2/teams/' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "name": "Sales US-West",
  "description"; null,
"members": [
"6VZszXPJqLXpIezcD5adESnwfPPUg",
"7xtVWXPJqLptLezceRadESnwfttOP"
],
"createTeamFolder": true
}'


Example Response:

{
    "teamId": "22340501-5fda-4000-8000-000000000001",
    "createdBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "updatedBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
    "createdAt": "2021-10-04T20:36:40.591Z",
    "updatedAt": "2021-10-04T20:36:40.591Z",
    "name": "Sales US-West",
   "description": null,
"isArchived": false
}

 

Update an Existing Team

Updates the team's metadata and returns the associated team object.

PATCH /v2/teams/{teamId}

Try it in Swagger

 

Permissions

  • The user account associated with the API access token must have access to edit teams. Only Admins have this level of access.
    Note: If you encounter a permission error for the given endpoint, check the permissions associated with your API token.

Parameters

name string [optional]

The name to be assigned to the new team.

 

description string [optional]

A description for the team.

 

cURL Request

curl --location --request PATCH 'https://api.sigmacomputing.com/v2/teams/{teamId}/ \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
   "name": string, // or undefined
  "description": string// or undefined
}'

 

Response

Returns a team object.

{
   "teamId": string,
   "createdBy": string,
   "updatedBy": string,
   "createdAt": string,
   "updatedAt": string,
   "name": string,
   "description": string | null,
   "isArchived": boolean
}

 

Example

Example Request:

curl --location --request PATCH 'https://api.sigmacomputing.com/v2/teams/22340501-5fda-4000-8000-000000000001' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
 "name": "Sales US-West",
  "description": "Sales team covering the west coast",
}'

 

Example Response:

{
   "teamId": "22340501-5fda-4000-8000-000000000001",
   "createdBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
   "updatedBy": "6VZszXPJqLXpIezcD5adESnwfPPUg",
   "createdAt": "2020-08-04T20:35:42.491Z",
   "updatedAt": "2021-10-04T20:36:40.591Z",
   "name": "Sales US-West",
   "description": null,
   "isArchived": false,
}

 

Add/Remove Team Members

Based on the entered parameters, adds or removes team members. Returns an empty object.

PATCH /v2/teams/{teamId}/members

Try it in Swagger

Permissions

  • The user account associated with the API access token must have permission to add/remove team members. Only Admins have this level of permission.
    Note: If you encounter a permission error for the given endpoint, check the permissions associated with your API token.

Parameters

add Array<memberId> [optional]

A list of organization members to add to the team.

remove Array<memberId> [optional]

A list of organization members to remove from the team.

cURL Request

curl --location --request PATCH 'https://api.sigmacomputing.com/v2/teams/{teamId}/members \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"add": Array<memberId>, // or undefined
"remove": Array<memberId> // or undefined
}'

 

Response

{}

 

Example

Example Request:

curl --location --request PATCH 'https://api.sigmacomputing.com/v2/teams/22340501-5fda-4000-8000-000000000001/members \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"add": [
"6VZszXPJqLXpIezcD5adESnwfPPUg",
"7xtVWXPJqLptLezceRadESnwfttOP"
]

}'

 

Example Response:

{}

 

Delete a Team

Deletes a team based on the provided unique identifier, teamId. Returns an empty object.

DELETE /v2/teams/{teamId}

Try it in Swagger

 

Permissions

  • The user account associated with the API access token must have permission to delete teams. Only Admins have this level of permission.
    Note: If you encounter a permission error for the given endpoint, check the permissions associated with your API token.

Parameters

None

cURL Request

curl --location --request DELETE 'https://api.sigmacomputing.com/v2/teams/{teamId} \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \

 

Response

Returns an empty object.

{}

 

Example

Example Request:

curl --location --request DELETE 'https://api.sigmacomputing.com/v2/teams/22340501-5fda-4000-8000-000000000001' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \

 

Example Response:

{}

 

Related Resources

API Documentation

Get Started with Sigma's API
Create an API Token and Client Id
Identify Unique Ids in Sigma

Product Documentation

People & Teams