---
title: "Update a team"
method: PATCH
path: "/api/v1/teams/{id}"
tags: ["Teams"]
---

# Update a team

`PATCH /api/v1/teams/{id}`

## Request

- Base URL: `https://api.atono.io`
- URL: `https://api.atono.io/api/v1/teams/{id}`
- Auth: API key in header `X-API-KEY`

## Path parameters

- `id` string, uuid, required

## Request body

- RequestTeamUpdateResourceV1
  - `data` TeamUpdateResourceV1, required: A team represents a group of people responsible for delivering and supporting work in Atono. Each team has its own backlog, workflow, and membership, and may be linked to a Slack channel for communication.
    - `type` string, required: Identifies the type of resource.
    - `id` string, uuid, required: The unique identifier for the resource, typically a UUID.
    - `attributes` TeamUpdateResourceV1Attributes: Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.
      - `name` string, nullable: The name of the team.
      - `description` string, nullable: The description of the team.
      - `isPublic` boolean, nullable: Indicates whether access to the team’s backlog is public (`true`) or private (`false`).
      - `backlogManagementByOwners` boolean, nullable: Indicates whether backlog management is enabled for the team (`true`) or not (`false`). When enabled, the team's backlog managers are responsible for managing stories in the 'To do' and 'Won't do' categories of the workflow.
      - `timezone` string, nullable: The IANA timezone identifier for the team (e.g., 'America/New_York', 'Europe/London'). This timezone is used for date calculations and display. If not specified, defaults to 'US/Pacific'.
    - `relationships` TeamUpdateResourceV1Relationships: Contains references to other related resources.
      - `members` MultipleRelationshipsUpdate
        - `data` ResourceIdentifier[], required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.

## Response `200`

Successfully updated the team.

- SingleResourceBodyTeamResourceV1
  - `data` TeamResourceV1: A team represents a group of people responsible for delivering and supporting work in Atono. Each team has its own backlog, workflow, and membership, and may be linked to a Slack channel for communication.
    - `type` string: Identifies the type of resource.
    - `id` string, uuid: The unique identifier for the resource, typically a UUID.
    - `attributes` TeamResourceV1Attributes: Contains the structured data fields that describe the resource, such as properties, settings, and timestamps.
      - `name` string: The name of the team.
      - `description` string: The description of the team.
      - `createdAt` string, date-time: The date and time the team was created.
      - `updatedAt` string, date-time: The date and time the team was last updated.
      - `isPublic` boolean: Indicates whether access to the team’s backlog is public (`true`) or private (`false`).
      - `backlogManagementByOwners` boolean: Indicates whether backlog management is enabled for the team (`true`) or not (`false`). When enabled, the team's backlog managers are responsible for managing stories in the 'To do' and 'Won't do' categories of the workflow.
      - `timezone` string: The IANA timezone identifier for the team (e.g., 'America/New_York', 'Europe/London'). This timezone is used for date calculations and display. If not specified, defaults to 'US/Pacific'.
    - `relationships` TeamResourceV1Relationships: Contains references to other related resources.
      - `members` MultipleRelationships
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier[], nullable, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
      - `channel` SingleRelationship
        - `links` RelationshipLinks, required
          - `self` string, uri, nullable, required
          - `related` string, uri, nullable, required
        - `data` ResourceIdentifier, required
          - `type` string, required: Identifies the type of the linked resource.
          - `id` string, required: The unique identifier of the linked resource.
        - `meta` unknown, required
  - `errors` ProblemDetail[]: A list of errors returned with the response, if the request could not be completed. Each object includes details about a specific issue.
    - `id` string: A unique identifier for this specific error occurrence. Useful for debugging and support.
    - `links` object, nullable: Links related to the error. May include a URL to relevant documentation or support resources.
    - `status` integer: The HTTP status code associated with the error (e.g., 400, 404, 422).
    - `code` string: An internal code that identifies the type or category of the error.
    - `title` string: A short summary of the problem.
    - `source` ProblemSource: Identifies the part of the request that caused the error. Only one source is present per error.
      - `pointer` string, nullable: Specifies the path to the field in the request body that caused the error.
      - `parameter` string, nullable: Identifies a query parameter in the request URL that caused the error.
      - `header` string, nullable: Identifies the request header that caused the error.
    - `detail` string: Additional information about the error, intended to provide more context than the title.
    - `meta` unknown
  - `meta` unknown
  - `included` unknown[]: A list of related resources included in the response, either automatically by the API or in response to an include parameter in the request. Each item contains a full resource object (e.g., users, teams, acceptance criteria).
    - unknown
  - `links` unknown

## Other responses

- `403`: The authenticated user does not have permission to update the specified team.
- `404`: The team could not be found, or one of the requested related resources (include) does not exist.

---

[API](https://skmtc.dev/atono/apis/backend-api.md) · [All operations](https://skmtc.dev/atono/apis/backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atono/apis/backend-api/revisions/78a57b1d8c3d?raw)