---
title: "Set a user attribute for teams"
method: POST
path: "/v2/user-attributes/{userAttributeId}/teams"
tags: ["User attributes"]
---

# Set a user attribute for teams

`POST /v2/user-attributes/{userAttributeId}/teams`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/user-attributes/{userAttributeId}/teams`
- Auth: HTTP bearer

Assign and set the value of a specific user attribute for one or more teams.

  ### Usage notes
  - Retrieve the **userAttributeId** by calling the [/v2/user-attributes](https://help.sigmacomputing.com/reference/list-user-attributes) endpoint.
  - Retrieve the **teamId** by calling the [/v2/teams](https://help.sigmacomputing.com/reference/list-teams) endpoint.

## Path parameters

- `userAttributeId` string, required

## Request body

- object
  - `assignments` V2UserAttributesUserAttributeIdTeamsPostRequestBodyContentApplicationJsonSchemaAssignmentsItems[], required
    - `teamId` string, required: Unique identifier of the team.
    - `value` V2UserAttributesUserAttributeIdTeamsPostRequestBodyContentApplicationJsonSchemaAssignmentsItemsValue, required: The value of the user attribute
      - `type` 'string', required: Type of user attribute.
      - `val` string, required: Value of the user attribute.

## Response `200`

The response body.

- UserAttributesSetUserAttributeForTeamsResponse200

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)