Get tool approval preferences
GET/v1/tool-approval-preferences
Returns the tool approval preferences for the authenticated user. These preferences control which tools require manual approval before execution, which run automatically, and which are disabled entirely.
When preferences are fetched, they are synced with the currently available tools from all connected MCP servers. Tools that no longer exist are pruned, and new tools receive their default approval mode.
To learn more about tool approval, see tool selection.
Request body schema (JSON)
{
"title": "Body"
}Responses
- 200
- 500
Default Response
Default Response
Responses (JSON)
{
"responses": {
"200": {
"description": "Default Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"preferences": {
"type": "object",
"properties": {
"toolOverrides": {
"type": "object",
"additionalProperties": {
"type": "string",
"enum": [
"approval",
"automatic"
]
},
"description": "A map of tool names to their approval mode. Each key is a tool name and each value is one of `approval` or `automatic`."
},
"disabledTools": {
"type": "array",
"items": {
"type": "string"
},
"description": "A list of tool names that are disabled and will not be available to the AI."
},
"updatedAt": {
"description": "The last time the preferences were updated.",
"type": "string",
"format": "date-time"
}
},
"required": [
"toolOverrides",
"disabledTools"
],
"additionalProperties": false
}
},
"required": [
"ok",
"preferences"
],
"additionalProperties": false
}
}
}
},
"500": {
"description": "Default Response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"details": {
"type": "object",
"additionalProperties": {}
}
},
"required": [
"ok",
"error"
],
"additionalProperties": false
}
}
}
}
}
}