Runs the specified command in the background, providing a run ID to check the status.

Request parameters

See Create a container for the full parameters.

Example request

JSON body:

• name: name of command to run (for example, diag)
• args: Array of argument values, as you would pass them when running a command on the terminal, with each array element being a space separated terminal argument.

curl -k -u soar_local_admin:changeme https://localhost/rest/command_run \
-d '[
{
"name": "playbooks_to_py3",
"args": ["local/testplaybook", "local"]
}
]'

Example response

A successful POST returns a success indicator and the Id of the updated container.

[
{
"success": true,
"id": <id>;
}
]

Get the status of all command runs executed.

Request parameters

A GET request to the /rest/command_run endpoint requires no arguments and returns a list.

Example request

Get the status of all command runs executed.

curl -X GET -u 'https://<username>:<password>@<instance_name>/rest/command_run

Example response

A successful GET will return a 200 response, and a JSON formatted list of the installed and launched automation brokers and their settings.

{
tbd
}

Get the status of all command runs executed.

Request parameters

A GET request to the /rest/command_run/<id> endpoint requires no arguments and returns a list.

Example request

Get the status of a particular command run by its ID.

curl -X GET -u 'https://<username>:<password>@<instance_name>/rest/command_run/<id>

Example response

A successful GET will return a 200 response, and a JSON formatted list with fields for id, status, start_time, end_time, command_name, and output.

{
tbd
}