This method allows you to update an existing team.

**Tip**: You can explore and test this endpoint interactively using our [OpenAPI documentation](https://api.deployhq.com/docs).

## URL

```
/teams/:identifier
```

## HTTP Method

```
PUT
```

## Supported Parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `team[name]` | String | No | The team name |
| `team[is_admin]` | Boolean | No | Whether the team has account administrator privileges |
| `team[can_manage_users]` | Boolean | No | Whether members can manage users |
| `team[can_manage_billing]` | Boolean | No | Whether members can manage billing |
| `team[can_manage_agents]` | Boolean | No | Whether members can manage network agents |
| `team[can_create_projects]` | Boolean | No | Whether members can create projects |
| `team[all_projects_allowed]` | Boolean | No | Whether members can access all projects |

## Example cURL Request

```
curl -X PUT \
-H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
-d '{"team": {"name": "Platform Engineering", "can_manage_agents": true}}' \
https://test.deployhq.com/teams/abc123-def456
```

## Example Response

```json
{
  "identifier": "abc123-def456",
  "name": "Platform Engineering",
  "is_admin": false,
  "can_manage_users": false,
  "can_manage_billing": false,
  "can_manage_agents": true,
  "can_create_projects": true,
  "all_projects_allowed": true,
  "members": [],
  "project_assignments": []
}
```

## Notes

* Returns the updated team
* Returns `422 Unprocessable Entity` if validation fails
* Switching `all_projects_allowed` from `false` to `true` will remove all existing project assignments