Update a team | Documentation

Updates the data associated with a team. Only organization admins and owners can update teams.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

organization_idstringRequired

The organization ID

team_idstringRequired

The team ID

This endpoint expects a map from strings to any.

OK - Updated team

$	curl -X PUT https://api.contentful.com/organizations/4EJGvuLTBUMG2A6wS8gfAS/teams/2v0NGpymMx5dc1sWjtiarg \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Updated Team Name",
>	"description": "Updated description"
>	}'

1	{
2	"name": "Updated Team Name",
3	"description": "Updated description",
4	"sys": {
5	"id": "7BslKh9TdKGOK41VmLDjFZ",
6	"type": "Team",
7	"organization": {
8	"sys": {
9	"type": "Link",
10	"linkType": "Organization",
11	"id": "4EJGvuLTBUMG2A6wS8gfAS"
12	}
13	},
14	"createdAt": "2025-08-22T06:24:46.000Z",
15	"updatedAt": "2025-08-22T06:24:46.000Z",
16	"memberCount": 0
17	}
18	}