RevoEngine Documentation

POST

/

api

/

v1

/

agents

/

{agentId}

/

run

Start an Agent run

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instruction": "Review the failed deployment and prepare a rollback recommendation."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    instruction: 'Review the failed deployment and prepare a rollback recommendation.'
  })
};

fetch('https://api.revoengine.com/api/v1/agents/{agentId}/run', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/agents/{agentId}/run"

payload = { "instruction": "Review the failed deployment and prepare a rollback recommendation." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Authorizations

Authorization

string

header

required

Bearer JWT token or API Key (sk-*).

Path Parameters

agentId

string

required

Body

application/json

instruction

string

required

Instruction or mission passed to the root agent run.

Minimum string length: 1

Example:

"Review the failed deployment and prepare a rollback recommendation."

triggerType

string

Optional trigger type such as REQUEST, EVENT, or SCHEDULE.

Example:

"SCHEDULE"

triggerRefType

string

Optional external reference type for correlation.

Example:

"scheduleId"

triggerRefId

string

Optional external reference id for correlation.

Example:

"44444444-4444-4444-8444-444444444444"

delaySeconds

number

Optional delay before the first tick is scheduled.

Required range: 0 <= x <= 2592000

Example:

30

state

object

Optional run-scoped state merged into the initial supervisor state.

Example:

{
  "incidentId": "INC-421",
  "severity": "high"
}

pluginIds

string<uuid>[]

Optional registry plugin ids attached for this run.

Example:

["55555555-5555-4555-8555-555555555555"]

Response

201 - undefined

Last modified on September 5, 2026

Start an Agent run

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instruction": "Review the failed deployment and prepare a rollback recommendation."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    instruction: 'Review the failed deployment and prepare a rollback recommendation.'
  })
};

fetch('https://api.revoengine.com/api/v1/agents/{agentId}/run', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/agents/{agentId}/run"

payload = { "instruction": "Review the failed deployment and prepare a rollback recommendation." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)