---
title: "Update team"
method: PUT
path: "/v1/teams/{id}"
tags: ["Team"]
---

# Update team

`PUT /v1/teams/{id}`

Updates an existing team's information. Only team owners can update team details.

## Path parameters

- `id` string, required

## Request body

- TeamUpdateDto
  - `organizationId` string
  - `name` string
  - `description` string
  - `image` string
  - `color` integer
  - `projectSalaryVisibility` integer
  - `deleted` boolean

## Response `200`

Updated team details

- TeamDto
  - `id` string
  - `organization` OrganizationDto
    - `id` string
    - `name` string
    - `description` string
    - `image` string
    - `color` integer
    - `subscription` CustomerSubscriptionDto
      - `id` string
      - `user` string
      - `expires` integer
      - `status` integer
      - `plan` integer
      - `licenses` integer
      - `paymentOption` string
      - `business` string
      - `email` string
      - `firstname` string
      - `lastname` string
      - `vatId` string
      - `displayName` string
      - `street` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string
      - `countryIso` string
      - `language` string
      - `includeTaxForBusiness` boolean
      - `activated` boolean
      - `pastDue` boolean
      - `cancellationOffer` boolean
      - `subscriptionActive` boolean
      - `subscriptionCancelled` boolean
      - `subscriptionInactive` boolean
      - `paymentProviderActive` boolean
      - `startedTestimonial` string, date-time
      - `activationDate` string, date-time
      - `cancellationDate` string, date-time
      - `permissionAdmin` boolean
      - `valid` boolean
      - `expired` boolean
      - `validAndActivated` boolean
      - `payPalPayment` boolean
      - `stripePayment` boolean
      - `invoicePayment` boolean
      - `googlePlayPayment` boolean
      - `appleStorePayment` boolean
      - `currency` string
      - `businessCustomer` boolean
      - `euCustomer` boolean
      - `eu` boolean
      - `at` boolean
      - `ch` boolean
      - `uk` boolean
      - `product` string
      - `licenseQuantity` integer
      - `active` boolean
      - `trial` boolean
      - `cancelled` boolean
      - `member` boolean
      - `businessOrTrial` boolean
      - `pro` boolean
      - `planEnterprise` boolean
      - `planBusiness` boolean
      - `planPro` boolean
      - `planPlus` boolean
      - `planBasic` boolean
      - `monthlyPlan` boolean
      - `yearlyPlan` boolean
      - `organization` boolean
    - `user` string
    - `aiChatEnabled` boolean
    - `lastUpdate` integer
    - `created` integer
    - `deleted` boolean
    - `permission` OrganizationPermissionDto
      - `invoicing` boolean
      - `billing` boolean
      - `admin` boolean
  - `organizationId` string
  - `name` string
  - `description` string
  - `image` string
  - `color` integer
  - `projectSalaryVisibility` integer
  - `user` string
  - `lastUpdate` integer
  - `created` integer
  - `deleted` boolean
  - `permission` TeamPermissionDto
    - `role` string
    - `manager` boolean
    - `owner` boolean
    - `member` boolean
    - `managerOrOwner` boolean
  - `projects` integer
  - `members` integer
  - `projectSalaryVisible` boolean

## Other responses

- `400` — Invalid request - missing required fields or validation errors
- `401` — Not authorized to update this team
- `404` — Team not found

---

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