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

# Update team

`PUT /teams/{teamId}`

## Request

- Base URL: `https://socialbu.com/api/v1`
- URL: `https://socialbu.com/api/v1/teams/{teamId}`
- Auth: HTTP bearer

Replaces the team's name, accounts, members, and approval settings in full. All fields are required — omitted accounts or members will be removed from the team.

## Path parameters

- `teamId` integer, required

## Request body

- object
  - `name` string, required: Name of the team.
  - `ai_context` string, nullable: Optional AI context for this team, such as brand voice, audience, products, or content goals. Send an empty string to clear it.
  - `accounts` object[], required
    - `id` integer: ID of the social media account to include in the team.
  - `members` object[]
    - `id` integer: ID of the member to be added to the team.
    - `permissions` unknown[]: Permissions assigned to the member.
      - unknown
  - `requires_content_approval` boolean: True if content requires approval before publishing.

## Response `200`

resource updated

- object
  - `success` boolean: True if the team was found.
  - `message` string: Message indicating the team was found successfully.

## Other responses

- `403`: Forbidden — plan limit exceeded or insufficient permissions.

---

[API](https://skmtc.dev/socialbu/apis/socialbu-api.md) · [All operations](https://skmtc.dev/socialbu/apis/socialbu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialbu/apis/socialbu-api/revisions/841b3ab0f671?raw)