Endpoint
Authentication
Requires Team Token with write permissions.
Request
Headers
Body
Partial configuration object. Only include fields you want to change.Request Example
Response
Success Response (200)
Approval Required Response (202)
When approval workflows are enabled:Error Responses
400 Bad Request - Invalid FieldImmutable Fields
These fields cannot be changed via API:team_name- Set by admin onlyorg_id- Fixed at team creationteam_node_id- Fixed at team creation
Common Updates
Add MCP Server
Update Agent Prompt
Enable Additional Tools
Disable Dangerous Tools
Update Slack Settings
Enable Feature Flags
Code Examples
Python
JavaScript
Validation
Before saving, the API validates:- Schema compliance - Fields match expected types
- Immutable fields - Cannot change protected fields
- Tool existence - Enabled tools must exist
- MCP server validity - MCP servers must be configured
Approval Workflows
If your organization has approval workflows enabled:- Updates create a pending change request
- Admins are notified
- Once approved, config is applied
- Requester is notified
Next Steps
Get Config
View current configuration
Configuration Guide
Configuration documentation

