Update a scenario
curl --request POST \
--url https://{command_center_host}/api/v1/scenarios/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"description": "",
"tags": [],
"hosts": [],
"agents": [],
"vars": {},
"ticket_title": "",
"ticket_body": "",
"prepare": [],
"validation": [],
"restore": [],
"status": "draft",
"id": "<string>",
"agent_hosts": {},
"agent_info": {},
"org_id": "<string>",
"tenant_id": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}
'import requests
url = "https://{command_center_host}/api/v1/scenarios/{id}"
payload = {
"title": "<string>",
"description": "",
"tags": [],
"hosts": [],
"agents": [],
"vars": {},
"ticket_title": "",
"ticket_body": "",
"prepare": [],
"validation": [],
"restore": [],
"status": "draft",
"id": "<string>",
"agent_hosts": {},
"agent_info": {},
"org_id": "<string>",
"tenant_id": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}
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({
title: '<string>',
description: '',
tags: [],
hosts: [],
agents: [],
vars: {},
ticket_title: '',
ticket_body: '',
prepare: [],
validation: [],
restore: [],
status: 'draft',
id: '<string>',
agent_hosts: {},
agent_info: {},
org_id: '<string>',
tenant_id: '<string>',
created_at: '<string>',
updated_at: '<string>'
})
};
fetch('https://{command_center_host}/api/v1/scenarios/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{command_center_host}/api/v1/scenarios/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'description' => '',
'tags' => [
],
'hosts' => [
],
'agents' => [
],
'vars' => [
],
'ticket_title' => '',
'ticket_body' => '',
'prepare' => [
],
'validation' => [
],
'restore' => [
],
'status' => 'draft',
'id' => '<string>',
'agent_hosts' => [
],
'agent_info' => [
],
'org_id' => '<string>',
'tenant_id' => '<string>',
'created_at' => '<string>',
'updated_at' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{command_center_host}/api/v1/scenarios/{id}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"description\": \"\",\n \"tags\": [],\n \"hosts\": [],\n \"agents\": [],\n \"vars\": {},\n \"ticket_title\": \"\",\n \"ticket_body\": \"\",\n \"prepare\": [],\n \"validation\": [],\n \"restore\": [],\n \"status\": \"draft\",\n \"id\": \"<string>\",\n \"agent_hosts\": {},\n \"agent_info\": {},\n \"org_id\": \"<string>\",\n \"tenant_id\": \"<string>\",\n \"created_at\": \"<string>\",\n \"updated_at\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{command_center_host}/api/v1/scenarios/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"description\": \"\",\n \"tags\": [],\n \"hosts\": [],\n \"agents\": [],\n \"vars\": {},\n \"ticket_title\": \"\",\n \"ticket_body\": \"\",\n \"prepare\": [],\n \"validation\": [],\n \"restore\": [],\n \"status\": \"draft\",\n \"id\": \"<string>\",\n \"agent_hosts\": {},\n \"agent_info\": {},\n \"org_id\": \"<string>\",\n \"tenant_id\": \"<string>\",\n \"created_at\": \"<string>\",\n \"updated_at\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{command_center_host}/api/v1/scenarios/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"description\": \"\",\n \"tags\": [],\n \"hosts\": [],\n \"agents\": [],\n \"vars\": {},\n \"ticket_title\": \"\",\n \"ticket_body\": \"\",\n \"prepare\": [],\n \"validation\": [],\n \"restore\": [],\n \"status\": \"draft\",\n \"id\": \"<string>\",\n \"agent_hosts\": {},\n \"agent_info\": {},\n \"org_id\": \"<string>\",\n \"tenant_id\": \"<string>\",\n \"created_at\": \"<string>\",\n \"updated_at\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "scn_af30b030-...",
"title": "nginx down",
"description": "<string>",
"tags": [
"<string>"
],
"ticket_title": "<string>",
"ticket_body": "<string>",
"vars": {},
"prepare": [
{}
],
"restore": [
{}
],
"validation": [
{
"label": "<string>",
"validator": "pattern_match",
"pattern": "<string>",
"where": "task_summary",
"required": true,
"negate": true
}
],
"status": "draft",
"hosts": [
"web-01"
],
"agents": [
"agent-linux-1"
],
"agent_hosts": {},
"agent_info": {},
"org_id": "org_460b541c-...",
"tenant_id": "ten_115bea44-...",
"created_at": "2026-08-26T10:00:26.380Z",
"updated_at": "2026-08-26T10:00:26.380Z"
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}Scenarios
Update a scenario
The body is the whole document, not a patch: steps and targets are ordered. Every save records a version.
POST
/
api
/
v1
/
scenarios
/
{id}
Update a scenario
curl --request POST \
--url https://{command_center_host}/api/v1/scenarios/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"description": "",
"tags": [],
"hosts": [],
"agents": [],
"vars": {},
"ticket_title": "",
"ticket_body": "",
"prepare": [],
"validation": [],
"restore": [],
"status": "draft",
"id": "<string>",
"agent_hosts": {},
"agent_info": {},
"org_id": "<string>",
"tenant_id": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}
'import requests
url = "https://{command_center_host}/api/v1/scenarios/{id}"
payload = {
"title": "<string>",
"description": "",
"tags": [],
"hosts": [],
"agents": [],
"vars": {},
"ticket_title": "",
"ticket_body": "",
"prepare": [],
"validation": [],
"restore": [],
"status": "draft",
"id": "<string>",
"agent_hosts": {},
"agent_info": {},
"org_id": "<string>",
"tenant_id": "<string>",
"created_at": "<string>",
"updated_at": "<string>"
}
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({
title: '<string>',
description: '',
tags: [],
hosts: [],
agents: [],
vars: {},
ticket_title: '',
ticket_body: '',
prepare: [],
validation: [],
restore: [],
status: 'draft',
id: '<string>',
agent_hosts: {},
agent_info: {},
org_id: '<string>',
tenant_id: '<string>',
created_at: '<string>',
updated_at: '<string>'
})
};
fetch('https://{command_center_host}/api/v1/scenarios/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{command_center_host}/api/v1/scenarios/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'description' => '',
'tags' => [
],
'hosts' => [
],
'agents' => [
],
'vars' => [
],
'ticket_title' => '',
'ticket_body' => '',
'prepare' => [
],
'validation' => [
],
'restore' => [
],
'status' => 'draft',
'id' => '<string>',
'agent_hosts' => [
],
'agent_info' => [
],
'org_id' => '<string>',
'tenant_id' => '<string>',
'created_at' => '<string>',
'updated_at' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{command_center_host}/api/v1/scenarios/{id}"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"description\": \"\",\n \"tags\": [],\n \"hosts\": [],\n \"agents\": [],\n \"vars\": {},\n \"ticket_title\": \"\",\n \"ticket_body\": \"\",\n \"prepare\": [],\n \"validation\": [],\n \"restore\": [],\n \"status\": \"draft\",\n \"id\": \"<string>\",\n \"agent_hosts\": {},\n \"agent_info\": {},\n \"org_id\": \"<string>\",\n \"tenant_id\": \"<string>\",\n \"created_at\": \"<string>\",\n \"updated_at\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://{command_center_host}/api/v1/scenarios/{id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"description\": \"\",\n \"tags\": [],\n \"hosts\": [],\n \"agents\": [],\n \"vars\": {},\n \"ticket_title\": \"\",\n \"ticket_body\": \"\",\n \"prepare\": [],\n \"validation\": [],\n \"restore\": [],\n \"status\": \"draft\",\n \"id\": \"<string>\",\n \"agent_hosts\": {},\n \"agent_info\": {},\n \"org_id\": \"<string>\",\n \"tenant_id\": \"<string>\",\n \"created_at\": \"<string>\",\n \"updated_at\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{command_center_host}/api/v1/scenarios/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"description\": \"\",\n \"tags\": [],\n \"hosts\": [],\n \"agents\": [],\n \"vars\": {},\n \"ticket_title\": \"\",\n \"ticket_body\": \"\",\n \"prepare\": [],\n \"validation\": [],\n \"restore\": [],\n \"status\": \"draft\",\n \"id\": \"<string>\",\n \"agent_hosts\": {},\n \"agent_info\": {},\n \"org_id\": \"<string>\",\n \"tenant_id\": \"<string>\",\n \"created_at\": \"<string>\",\n \"updated_at\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"id": "scn_af30b030-...",
"title": "nginx down",
"description": "<string>",
"tags": [
"<string>"
],
"ticket_title": "<string>",
"ticket_body": "<string>",
"vars": {},
"prepare": [
{}
],
"restore": [
{}
],
"validation": [
{
"label": "<string>",
"validator": "pattern_match",
"pattern": "<string>",
"where": "task_summary",
"required": true,
"negate": true
}
],
"status": "draft",
"hosts": [
"web-01"
],
"agents": [
"agent-linux-1"
],
"agent_hosts": {},
"agent_info": {},
"org_id": "org_460b541c-...",
"tenant_id": "ten_115bea44-...",
"created_at": "2026-08-26T10:00:26.380Z",
"updated_at": "2026-08-26T10:00:26.380Z"
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}{
"code": "VALIDATION_FAILED",
"message": "Validation failed",
"request_id": "req_3702b7e7-...",
"field": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
],
"details": {}
}Authorizations
An API key minted in Command Center (Settings -> API Keys), sent as Authorization: Bearer 2501_ak_.... A Command Center session cookie is also accepted.
Path Parameters
Body
application/json
Minimum string length:
1Minimum string length:
1Minimum string length:
1Minimum string length:
1Show child attributes
Show child attributes
- Option 1
- Option 2
Show child attributes
Show child attributes
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
Show child attributes
Show child attributes
- Option 1
- Option 2
Show child attributes
Show child attributes
Available options:
draft, published, disabled Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
The updated scenario
Example:
"scn_af30b030-..."
Example:
"nginx down"
Show child attributes
Show child attributes
Ordered shell commands, each { run, on? }, in the shape POST /api/v1/scenarios accepts.
Show child attributes
Show child attributes
Ordered shell commands, each { run, on? }, in the shape POST /api/v1/scenarios accepts.
Show child attributes
Show child attributes
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
Show child attributes
Show child attributes
Available options:
draft, published, disabled Example:
["web-01"]
Example:
["agent-linux-1"]
Agent name to the host it is attached to
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Example:
"org_460b541c-..."
Example:
"ten_115bea44-..."
Example:
"2026-08-26T10:00:26.380Z"
Example:
"2026-08-26T10:00:26.380Z"