Create a team

POST

/v2/teams

Create a Sigma team.

Usage notes

Specify members to add to the team by userId or memberId.
Retrieve the memberId by calling the /v2/members endpoint.

Create a Sigma team. ### Usage notes - Specify members to add to the team by userId or memberId. - Retrieve the **memberId** by calling the [/v2/members](https://help.sigmacomputing.com/reference/list-members) endpoint.

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Request

The request body.

namestringRequired

descriptionstringOptional

memberslist of stringsOptional

Specify memberIds

createTeamFolderbooleanOptional

visibilityenumOptional

Whether to make a public or private team. Defaults to private.

Allowed values:

Response

The response body.

teamIdstring

createdBystring

updatedBystring

createdAtdatetime

updatedAtdatetime

namestring

descriptionstring or null

visibilityenum

memberslist of strings

workspaceIdstring or null

isArchivedboolean

$	curl -X POST https://api.sigmacomputing.com/v2/teams \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Data Analytics Team"
>	}'

1	{
2	"teamId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
3	"createdBy": "user_987654321",
4	"updatedBy": "user_987654321",
5	"createdAt": "2024-01-15T09:30:00Z",
6	"updatedAt": "2024-01-15T09:30:00Z",
7	"name": "Data Analytics Team",
8	"description": "Team responsible for data analysis and reporting",
9	"visibility": "public",
10	"members": [
11	"member_123456789"
12	],
13	"workspaceId": "workspace_456789123",
14	"isArchived": true
15	}