Validate Assistant configuration without creating a thread.
Read-only validation of persisted instructions, context, strict response schema, selected tools and approval policies against current admission.
curl --request POST \
--url https://api.revoengine.com/api/v1/assistant/configuration/validate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.revoengine.com/api/v1/assistant/configuration/validate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/assistant/configuration/validate"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"valid": true,
"normalized": {
"instructions": "<string>",
"contextMode": "platform",
"responseFormat": {
"type": "text",
"schema": {},
"strict": true
},
"permissions": "default",
"toolPermissions": {},
"toolNames": [
"ref_search"
],
"pluginIds": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"toolNames": [
"ref_search"
],
"effectiveToolNames": [
"ref_search"
]
}Authorizations
Bearer JWT token or API Key (sk-*).
Body
Instructions persisted on this thread across follow-up messages, Resume, same-owner forks and compaction. Maximum 16 KiB UTF-8 and 16 KiB after safe instruction rendering. Supplements mandatory runtime and instance-global instructions; never grants tool permissions. Immutable after creation.
16000Persisted context profile. platform preserves the normal Revo Assistant. minimal keeps instance-global and account standing instructions and safety, omits automatic memory and plugin discovery/preload, and admits only explicitly selected tools/plugins. Defaults to platform. Immutable after creation.
platform, minimal Persisted final-answer format, also enforced on browser follow-ups and Resume. Defaults to text. Immutable after creation.
Show child attributes
Show child attributes
Per-turn approval policy. default requires approval for side-effecting tool calls, auto_review uses conditional safe auto-review, and full skips normal approval gates.
default, auto_review, full Optional per-tool approval policy overrides. Runtime sanitizes keys and enum values before persisting them.
Show child attributes
Show child attributes
Optional allowlist of operational tool names for this turn. Omit to allow the gateway default surface; pass an empty array to admit no tools for direct-answer turns.
ref_search, ref_describe, ref_apply, snapshot_get, snapshot_history, snapshot_diff, storage, skill_search, skill_load, memory_search, memory_load, memory_save, plan_update, code_search, code_read, code_exec, ops_investigate, platform_api_find_operation, dependency_graph, web_search, web_load, web_rich_lookup, wait, conversation_search, conversation_load, attachment_load, send_message, agent_handoff, agent_delegate, plugin_search, plugin_load, plugin_call, request_clarification, code_describe, generate_widget, terminal_exec, terminal, studio, tool_exec, tool_wait, tool_status, tool_cancel Optional registry plugin ids attached to this assistant turn.
Response
true Show child attributes
Show child attributes
null means default selection; an empty array means no tools.
ref_search, ref_describe, ref_apply, snapshot_get, snapshot_history, snapshot_diff, storage, skill_search, skill_load, memory_search, memory_load, memory_save, plan_update, code_search, code_read, code_exec, ops_investigate, platform_api_find_operation, dependency_graph, web_search, web_load, web_rich_lookup, wait, conversation_search, conversation_load, attachment_load, send_message, agent_handoff, agent_delegate, plugin_search, plugin_load, plugin_call, request_clarification, code_describe, generate_widget, terminal_exec, terminal, studio, tool_exec, tool_wait, tool_status, tool_cancel ref_search, ref_describe, ref_apply, snapshot_get, snapshot_history, snapshot_diff, storage, skill_search, skill_load, memory_search, memory_load, memory_save, plan_update, code_search, code_read, code_exec, ops_investigate, platform_api_find_operation, dependency_graph, web_search, web_load, web_rich_lookup, wait, conversation_search, conversation_load, attachment_load, send_message, agent_handoff, agent_delegate, plugin_search, plugin_load, plugin_call, request_clarification, code_describe, generate_widget, terminal_exec, terminal, studio, tool_exec, tool_wait, tool_status, tool_cancel curl --request POST \
--url https://api.revoengine.com/api/v1/assistant/configuration/validate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.revoengine.com/api/v1/assistant/configuration/validate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/assistant/configuration/validate"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"valid": true,
"normalized": {
"instructions": "<string>",
"contextMode": "platform",
"responseFormat": {
"type": "text",
"schema": {},
"strict": true
},
"permissions": "default",
"toolPermissions": {},
"toolNames": [
"ref_search"
],
"pluginIds": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
]
},
"toolNames": [
"ref_search"
],
"effectiveToolNames": [
"ref_search"
]
}