Update a team

PATCH

/api/teams/{id}

Maintainer:Not configured

OperationId:update_team

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Team metadata updated

Bodyapplication/json

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/teams/' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "description": "string",
    "name": "string"
}'

Response Example

200 - Example 1

{
    "auto_join_role": "owner",
    "created": "2019-08-24T14:15:22.123Z",
    "description": "string",
    "elevated_mappings": [
        {
            "group": "string",
            "idp_key": "string",
            "role": "owner",
            "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba"
        }
    ],
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "public_within": {
        "dormant": [
            {
                "anchor": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                },
                "team": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                }
            }
        ],
        "dormant_unnamed": 0,
        "lapsed": [
            {
                "anchor": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                },
                "team": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                }
            }
        ],
        "lapsed_unnamed": 0,
        "revived": [
            {
                "anchor": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                },
                "team": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                }
            }
        ],
        "revived_unnamed": 0
    },
    "public_within_in_reach": {
        "rows": [
            {
                "anchor": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                },
                "team": {
                    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                    "name": "string",
                    "slug": "string"
                }
            }
        ],
        "unnamed": 0
    },
    "slug": "string"
}

Modified at 2026-10-31 03:28:43

Delete a team

Add a member to a team