---
title: "Update a team"
method: PUT
path: "/api-public/v1/team/{team}"
tags: ["Teams"]
---

# Update a team

`PUT /api-public/v1/team/{team}`

Update the designated team

This API may be called a maximum of 2 times per second.

## Path parameters

- `team` string, required

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Request body

- AddTeamPayload — The team information
  - `name` string, required
  - `description` string — Optional field, max length 1024 characters.

## Response `200`

Some details about the team that was added

- AddTeamResponse — Some info about the team
  - `_selfUrl` string
  - `_membersUrl` string
  - `_policiesUrl` string
  - `_adminsUrl` string
  - `name` string
  - `slug` string
  - `memberCount` number
  - `version` number
  - `isDefaultTeam` boolean
  - `description` string — Optional field, returned if set.

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Team not found
- `422` — Team name or email is unavailable, or you have reached your team limit.
- `500` — Internal Server Error

---

[API](https://skmtc.net/victorops/apis/victorops-api.md) · [All operations](https://skmtc.net/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)