Skip to main content

Update a Team

This article provides an example of calling the Update a Team API.

  • This API is only available for spaces on the enterprise plan.(Learn more).
  • Only the primary admin and sub-admins who can manage teams and roles can use this API.


Suppose you have a space and you want to change the name of the "Product Group" to "Product Department" and modify its sequence to 2.

Follow these steps:

  1. Get your API Token. (How to get it)

  2. Get your Space ID. (How to get it)

  3. Get the unitId of the "Product Group" (How to get it)

    What is unitId?

  4. Open the terminal on your computer and execute the following code to send a query request to the server (assuming the spaceId is spcjXzqVrjaP3 and the unitId of the "Product Group" is E3jG1xNzR2iM4tL6XmYyKpFqWuV8vDc):

    curl -X PUT \
    "" \
    -H "Authorization: Bearer {Your API Token}" \
    -H 'Content-Type: application/json' \
    -d '{
    "name": "Product Department",
  5. The server will return the following JSON data, with the updated team information under the "data":

    For the meaning of each parameter in the response, please check the API Reference.

    "code": 200,
    "message": "SUCCESS",
    "success": true,
    "data": {
    "team": {
    "unitId": "E3jG1xNzR2iM4tL6XmYyKpFqWuV8vDc",
    "name": "Product Department",
    "roles": []