> ## Documentation Index > Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a team ## OpenAPI ````yaml /api-reference/openapi.json put /v1/teams/{team_id} openapi: 3.1.0 info: title: Feather API description: >- Unified customer experience platform API. Manages identity, conversations, memory, agents, procedures, policies, model routing, knowledge bases, integrations, and runtime execution. version: 1.21.0 servers: - url: https://api-sandbox.featherhq.com description: Sandbox - url: http://localhost:8000 description: Local dev security: [] paths: /v1/teams/{team_id}: put: tags: - teams summary: Update a team operationId: updateTeam parameters: - name: team_id in: path required: true schema: type: string format: uuid title: Team Id requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/TeamUpdate' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/TeamResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: TeamUpdate: properties: name: anyOf: - type: string - type: 'null' title: Name description: anyOf: - type: string - type: 'null' title: Description metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: Metadata type: object title: TeamUpdate TeamResponse: properties: id: type: string format: uuid title: Id organization_id: type: string format: uuid title: Organization Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description active_revision_id: anyOf: - type: string format: uuid - type: 'null' title: Active Revision Id active_revision: anyOf: - $ref: '#/components/schemas/TeamRevisionResponse' - type: 'null' metadata: additionalProperties: true type: object title: Metadata created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - organization_id - name - created_at - updated_at title: TeamResponse ErrorResponse: properties: error: type: string title: Error message: type: string title: Message type: object required: - error - message title: ErrorResponse description: Standard error response returned by all API error handlers. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TeamRevisionResponse: properties: id: type: string format: uuid title: Id team_id: type: string format: uuid title: Team Id name: type: string title: Name description: anyOf: - type: string - type: 'null' title: Description purpose: anyOf: - type: string - type: 'null' title: Purpose mode: type: string title: Mode fallback_member_id: type: string format: uuid title: Fallback Member Id initial_member_id: anyOf: - type: string format: uuid - type: 'null' title: Initial Member Id swarm_domain_hint: anyOf: - type: string - type: 'null' title: Swarm Domain Hint swarm_max_hops: type: integer title: Swarm Max Hops router_config_id: anyOf: - type: string format: uuid - type: 'null' title: Router Config Id router_model_settings: anyOf: - $ref: '#/components/schemas/ModelChainEntry' - type: 'null' members: items: $ref: '#/components/schemas/TeamMemberResponse' type: array title: Members created_by: anyOf: - type: string - type: 'null' title: Created By created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - team_id - name - mode - fallback_member_id - swarm_max_hops - created_at - updated_at title: TeamRevisionResponse ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ModelChainEntry: properties: model: type: string title: Model config: $ref: '#/components/schemas/ModelConfig' type: object required: - model title: ModelChainEntry TeamMemberResponse: properties: id: type: string format: uuid title: Id assistant_id: type: string format: uuid title: Assistant Id assistant_name: type: string title: Assistant Name assistant_revision_id: anyOf: - type: string format: uuid - type: 'null' title: Assistant Revision Id router_name: anyOf: - type: string - type: 'null' title: Router Name router_description: anyOf: - type: string - type: 'null' title: Router Description examples: items: type: string type: array title: Examples model_settings: anyOf: - $ref: '#/components/schemas/ModelChainEntry' - type: 'null' position: type: integer title: Position enabled: type: boolean title: Enabled created_at: type: string format: date-time title: Created At type: object required: - id - assistant_id - assistant_name - position - enabled - created_at title: TeamMemberResponse ModelConfig: properties: temperature: anyOf: - type: number - type: 'null' title: Temperature max_tokens: anyOf: - type: integer - type: 'null' title: Max Tokens top_p: anyOf: - type: number - type: 'null' title: Top P stop_sequences: anyOf: - items: type: string type: array - type: 'null' title: Stop Sequences reasoning_effort: anyOf: - type: string enum: - none - low - medium - high - xhigh - type: 'null' title: Reasoning Effort request_timeout_ms: anyOf: - type: integer - type: 'null' title: Request Timeout Ms thinking_budget: anyOf: - type: integer minimum: 1 - type: 'null' title: Thinking Budget type: object title: ModelConfig securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````