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

# Update team

`PUT /teams/{id}`

Update an existing team.

**gigstack Connect:** Update other teams using the `team` parameter.

## Path parameters

- `id` string, required

## Query parameters

- `team` string

## Request body

- TeamInput
  - `address` object, nullable
    - `country` string
    - `street` string, nullable
    - `zip` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `exterior` string, nullable
    - `interior` string, nullable
    - `municipality` string, nullable
    - `neighborhood` string, nullable
  - `brand` object, nullable
    - `alias` string
    - `primary_color` string, nullable
    - `secondary_color` string, nullable
    - `logo` string, nullable
  - `metadata` object, nullable — Additional metadata to store with the team
  - `support_email` string, email, nullable
  - `support_phone` string, nullable
  - `tax_id` string, nullable
  - `tax_system` string, nullable
  - `generate_onboarding_url` boolean, nullable — Generate onboarding URL for team setup
  - `add_members` object[], nullable — Array of members to add to the team on creation
    - `id` string, required — User ID to add as a team member
    - `role` 'admin' | 'editor' | 'viewer' — Role for the team member. Defaults to "viewer" if not specified.
  - `legal_name` string, nullable — Legal name of the team/company
  - `add_master_team_members` boolean, nullable — When true, copies all members from the master team to the newly created team with their existing permissions
  - `credit_limit` number, nullable — Maximum number of documents (credits) the team can create per billing period. When null or omitted, the team shares the billing account pool with no per-team cap.

## Response `200`

Team updated successfully

- StandardSuccessResponse
  - `message` string, required
  - `data` object, required

---

[API](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2.md) · [All operations](https://skmtc.dev/disruptive-learning/apis/gigstack-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/disruptive-learning/gigstack-api-v2/revisions/5cf53ffd7580/schema)