Simulate a request through the route
curl --request POST \
--url https://api.opper.ai/management/v1/dynamic-routes/{name}/simulate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {},
"metadata": {},
"overrides": {
"classifier_cases": {},
"conditional_cases": {},
"model_outcomes": {},
"percentage_buckets": {}
},
"request_id": "<string>",
"version_number": 2
}
'import requests
url = "https://api.opper.ai/management/v1/dynamic-routes/{name}/simulate"
payload = {
"input": {},
"metadata": {},
"overrides": {
"classifier_cases": {},
"conditional_cases": {},
"model_outcomes": {},
"percentage_buckets": {}
},
"request_id": "<string>",
"version_number": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
input: {},
metadata: {},
overrides: {
classifier_cases: {},
conditional_cases: {},
model_outcomes: {},
percentage_buckets: {}
},
request_id: '<string>',
version_number: 2
})
};
fetch('https://api.opper.ai/management/v1/dynamic-routes/{name}/simulate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"overrides": {
"classifier_cases": {},
"conditional_cases": {},
"model_outcomes": {},
"percentage_buckets": {}
},
"path": [
{
"node_id": "<string>",
"node_type": "<string>",
"model": "<string>",
"node_label": "<string>",
"outcome": "<string>",
"output": "<string>",
"ranked_models": [
"<string>"
],
"target_node_id": "<string>"
}
],
"status": "<string>",
"result": {}
},
"meta": {
"target": {
"kind": "draft",
"version_number": 2
}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}{
"error": "<string>",
"required_scope": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}Management
Simulate a request through the route
Omit version_number or set it to null to simulate the current draft, including an unpublished route. To simulate history, supply a positive version_number from list_dynamic_route_versions. Zero is invalid and does not mean draft. Minimal draft call: {"name":"support","version_number":null}. Optional input and metadata supply request context; overrides.model_outcomes maps model/pool node IDs to success or fallback, and overrides.classifier_cases maps classifier node IDs to case IDs. For example {"name":"support","version_number":null,"overrides":{"model_outcomes":{"primary":"success"}}} tests the documented example graph. May call a live classifier when no override is provided; does not deploy or invoke the selected final model. Inspect data.status and data.path for the routing verdict. Fix draft issues with update_dynamic_route_draft before deployment. Requires the `dynamic_routes:write` scope.
POST
/
management
/
v1
/
dynamic-routes
/
{name}
/
simulate
Simulate a request through the route
curl --request POST \
--url https://api.opper.ai/management/v1/dynamic-routes/{name}/simulate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {},
"metadata": {},
"overrides": {
"classifier_cases": {},
"conditional_cases": {},
"model_outcomes": {},
"percentage_buckets": {}
},
"request_id": "<string>",
"version_number": 2
}
'import requests
url = "https://api.opper.ai/management/v1/dynamic-routes/{name}/simulate"
payload = {
"input": {},
"metadata": {},
"overrides": {
"classifier_cases": {},
"conditional_cases": {},
"model_outcomes": {},
"percentage_buckets": {}
},
"request_id": "<string>",
"version_number": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
input: {},
metadata: {},
overrides: {
classifier_cases: {},
conditional_cases: {},
model_outcomes: {},
percentage_buckets: {}
},
request_id: '<string>',
version_number: 2
})
};
fetch('https://api.opper.ai/management/v1/dynamic-routes/{name}/simulate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"overrides": {
"classifier_cases": {},
"conditional_cases": {},
"model_outcomes": {},
"percentage_buckets": {}
},
"path": [
{
"node_id": "<string>",
"node_type": "<string>",
"model": "<string>",
"node_label": "<string>",
"outcome": "<string>",
"output": "<string>",
"ranked_models": [
"<string>"
],
"target_node_id": "<string>"
}
],
"status": "<string>",
"result": {}
},
"meta": {
"target": {
"kind": "draft",
"version_number": 2
}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}{
"error": "<string>",
"required_scope": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {}
}Authorizations
Body
application/json
Last modified on September 17, 2026