Replace instance configuration
put_instance_configReplace an instance's entire configuration (like clerk config put); the change applies to the live instance immediately. config must include every top-level key, so start from get_instance_config; a config missing any key is rejected. Returns the before and after values and the new config_version. Run with dry_run first.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"application_id": "<application_id>",
"instance": "<instance>",
"config": "<config>"
},
"name": "put_instance_config"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| config | Yes | Configuration keyed by top-level config key, in the shape get_instance_config returns. get_instance_config_schema lists the valid keys and fields. | |
| dry_run | No | Preview the change without applying it. | |
| instance | Yes | Instance to target: "development", "production", or a full instance ID (ins_…). | |
| destructive | No | Allow changes that delete resources instead of resetting them: session templates, custom OAuth providers, and minimum app versions (a null entry or platform in native_app_minimum_versions). | |
| application_id | Yes | Clerk application ID (app_…). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | ||
| before | No | ||
| dry_run | No | ||
| config_version | No |