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

# Update Team

`PUT /api/v1/teams/{team_id_or_identifier}`

## Request

- Base URL: `https://api.gnosari.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gnosari.com/api/v1/teams/{team_id_or_identifier}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-AUTH-TOKEN`

Update a team.
Supports both numeric IDs and string identifiers.

## Path parameters

- `team_id_or_identifier` string, required

## Request body

- TeamApiUpdate: Schema for partial team updates via API.
  - `name` string, nullable
  - `description` string, nullable
  - `identifier` string, nullable
  - `parameters` unknown[], nullable
    - unknown
  - `image` string, nullable
  - `version` string
  - `tags` string[]
  - `config` object, nullable
  - `components_include` string[], nullable
  - `components_exclude` string[], nullable
  - `created_by` string, nullable
  - `access_level` 'PRIVATE' | 'PASSWORD_PROTECTED' | 'PUBLIC'
  - `access_password` string, nullable
  - `suggested_prompts` SuggestedPromptsConfigSchema: Schema for suggested prompts configuration. Used in Agent and Team create/update operations. Provides a complete configuration including enabled state and the list of prompts.
    - `enabled` boolean: Whether to show suggested prompts in chat
    - `prompts` CoreSchemasSuggestedPromptSuggestedPromptSchema[]: List of suggested prompts (max 8)
      - `id` union, required: Unique identifier for the prompt
        - integer
        - string
      - `icon` string: Heroicons icon name (e.g., 'i-heroicons-light-bulb')
      - `title` string, required: Short title displayed on the prompt button
      - `text` string, required: The actual prompt text sent when clicked
  - `agent_ids` integer[], nullable

## Response `200`

Successful Response

- Team: Full team schema with database fields and agent list.
  - `name` string, required
  - `description` string, nullable
  - `identifier` string, nullable
  - `parameters` unknown[], nullable
    - unknown
  - `image` string, nullable
  - `version` string
  - `tags` string[]
  - `config` object, nullable
  - `components_include` string[], nullable
  - `components_exclude` string[], nullable
  - `created_by` string, nullable
  - `access_level` 'PRIVATE' | 'PASSWORD_PROTECTED' | 'PUBLIC'
  - `access_password` string, nullable
  - `suggested_prompts` SuggestedPromptsConfigSchema: Schema for suggested prompts configuration. Used in Agent and Team create/update operations. Provides a complete configuration including enabled state and the list of prompts.
    - `enabled` boolean: Whether to show suggested prompts in chat
    - `prompts` CoreSchemasSuggestedPromptSuggestedPromptSchema[]: List of suggested prompts (max 8)
      - `id` union, required: Unique identifier for the prompt
        - integer
        - string
      - `icon` string: Heroicons icon name (e.g., 'i-heroicons-light-bulb')
      - `title` string, required: Short title displayed on the prompt button
      - `text` string, required: The actual prompt text sent when clicked
  - `id` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `agents` Agent[]

## Other responses

- `422`: Validation Error

---

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