Continue an Agent run

POST

api

agents

runs

{agentRunId}

continue

Continue an Agent run

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/runs/{agentRunId}/continue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instruction": "Now compare the result with the previous month and update the recommendation."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    instruction: 'Now compare the result with the previous month and update the recommendation.'
  })
};

fetch('https://api.revoengine.com/api/v1/agents/runs/{agentRunId}/continue', 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/runs/{agentRunId}/continue"

payload = { "instruction": "Now compare the result with the previous month and update the recommendation." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "agentRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "agentId": "99999999-9999-4999-8999-999999999999",
  "agentSessionId": "abababab-abab-4bab-8bab-abababababab",
  "status": "PROCESSING",
  "serviceAccountUserId": "11111111-1111-4111-8111-111111111111",
  "tickSeq": 3,
  "tickCount": 2,
  "childCount": 1,
  "state": {
    "instruction": "Review deployment"
  },
  "createdAt": "2026-06-13T10:00:00.000Z",
  "lastUpdateAt": "2026-06-13T10:15:00.000Z",
  "version": 1,
  "previousRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "rootRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "parentRunId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
  "waitReason": "CHILDREN",
  "triggerType": "REQUEST",
  "triggerRefType": "scheduleId",
  "triggerRefId": "schedule-123",
  "ownerId": "22222222-2222-4222-8222-222222222222",
  "ownerType": "USER",
  "rootAssistantThreadId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
  "currentAssistantThreadId": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
  "lastAssistantMessageId": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee",
  "nextWakeAt": "2026-06-13T10:30:00.000Z",
  "scheduledFor": "2026-06-13T10:30:00.000Z",
  "lastHeartbeatAt": "2026-06-13T10:20:00.000Z",
  "checkpointSummary": "Run completed and wrote the release summary.",
  "result": {
    "summary": "Deployment looks healthy."
  },
  "error": {
    "message": "Run failed."
  }
}

Authorizations

Authorization

string

header

required

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

Path Parameters

agentRunId

string

required

Body

application/json

instruction

string

required

New user instruction appended to the durable Agent session as a successor run.

Minimum string length: 1

Example:

"Now compare the result with the previous month and update the recommendation."

storageEntryIds

string[]

Finalized Storage files attached to the continuation message.

Maximum array length: 8

Example:

["44444444-4444-4444-8444-444444444444"]

pluginIds

string[]

Registry plugins attached to the successor run.

Maximum array length: 32

Example:

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

model

enum<string>

Optional model override for the successor run.

Available options:

gpt-6.1-sol,

gpt-6-luna

Example:

"gpt-6.1-sol"

reasoningEffort

enum<string>

Optional reasoning effort override for the successor run.

Available options:

none,

low,

medium,

high,

xhigh

Example:

"medium"

planningPolicy

enum<string>

Optional planning policy override for the successor run.

Available options:

standard,

review_required

Example:

"standard"

fastMode

boolean

Enable fast mode for the successor run.

Example:

true

backgroundProcessing

boolean

Process the successor run in the background.

Example:

true

Response

200 - application/json

agentRunId

string

required

Stable run id.

Example:

"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"

agentId

string

required

Owning agent id.

Example:

"99999999-9999-4999-8999-999999999999"

agentSessionId

string

required

Durable session shared by successor runs.

Example:

"abababab-abab-4bab-8bab-abababababab"

status

enum<string>

required

Current run status.

Available options:

CREATED,

PENDING,

PROCESSING,

ACTION_REQUIRED,

FINISHED,

ERROR,

CANCELLED

Example:

"PROCESSING"

serviceAccountUserId

string

required

Service account execution principal.

Example:

"11111111-1111-4111-8111-111111111111"

tickSeq

number

required

Current tick sequence.

Example:

3

tickCount

number

required

Number of ticks executed.

Example:

2

childCount

number

required

Number of child runs created.

Example:

1

state

object

required

Run-scoped state for operator diagnostics.

Example:

{ "instruction": "Review deployment" }

createdAt

string<date-time>

required

Creation timestamp.

Example:

"2026-06-13T10:00:00.000Z"

lastUpdateAt

string<date-time>

required

Last update timestamp.

Example:

"2026-06-13T10:15:00.000Z"

version

number

required

Optimistic locking version.

Example:

1

previousRunId

string

Immediately preceding run in this session.

Example:

"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"

rootRunId

string

Root run id for lineage.

Example:

"aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"

parentRunId

string

Parent run id for delegated child runs.

Example:

"bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb"

waitReason

enum<string>

Reason a run is waiting.

Available options:

NONE,

CHILDREN,

CAPACITY,

SCHEDULE,

RECONCILE

Example:

"CHILDREN"

triggerType

string

Trigger type such as REQUEST, INBOX, SCHEDULE, EVENT, or RETRY.

Example:

"REQUEST"

triggerRefType

string

External trigger reference type.

Example:

"scheduleId"

triggerRefId

string

External trigger reference id.

Example:

"schedule-123"

ownerId

string

Owning user or group id.

Example:

"22222222-2222-4222-8222-222222222222"

ownerType

string

Owner type, typically USER or GROUP.

Example:

"USER"

rootAssistantThreadId

string

Root assistant thread for the run.

Example:

"cccccccc-cccc-4ccc-8ccc-cccccccccccc"

currentAssistantThreadId

string

Current assistant thread for the run.

Example:

"dddddddd-dddd-4ddd-8ddd-dddddddddddd"

lastAssistantMessageId

string

Last assistant message id.

Example:

"eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee"

nextWakeAt

string<date-time>

Next scheduled wake timestamp.

Example:

"2026-06-13T10:30:00.000Z"

scheduledFor

string<date-time>

Accepted initial dispatch deadline. Independent of later continuation wake times.

Example:

"2026-06-13T10:30:00.000Z"

lastHeartbeatAt

string<date-time>

Last heartbeat timestamp.

Example:

"2026-06-13T10:20:00.000Z"

checkpointSummary

string

Bounded terminal or checkpoint summary.

Example:

"Run completed and wrote the release summary."

result

object

Terminal result payload.

Example:

{ "summary": "Deployment looks healthy." }

error

object

Terminal error payload.

Example:

{ "message": "Run failed." }

Continue an Agent run

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/runs/{agentRunId}/continue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instruction": "Now compare the result with the previous month and update the recommendation."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    instruction: 'Now compare the result with the previous month and update the recommendation.'
  })
};

fetch('https://api.revoengine.com/api/v1/agents/runs/{agentRunId}/continue', 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/runs/{agentRunId}/continue"

payload = { "instruction": "Now compare the result with the previous month and update the recommendation." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "agentRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "agentId": "99999999-9999-4999-8999-999999999999",
  "agentSessionId": "abababab-abab-4bab-8bab-abababababab",
  "status": "PROCESSING",
  "serviceAccountUserId": "11111111-1111-4111-8111-111111111111",
  "tickSeq": 3,
  "tickCount": 2,
  "childCount": 1,
  "state": {
    "instruction": "Review deployment"
  },
  "createdAt": "2026-06-13T10:00:00.000Z",
  "lastUpdateAt": "2026-06-13T10:15:00.000Z",
  "version": 1,
  "previousRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "rootRunId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "parentRunId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
  "waitReason": "CHILDREN",
  "triggerType": "REQUEST",
  "triggerRefType": "scheduleId",
  "triggerRefId": "schedule-123",
  "ownerId": "22222222-2222-4222-8222-222222222222",
  "ownerType": "USER",
  "rootAssistantThreadId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
  "currentAssistantThreadId": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
  "lastAssistantMessageId": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee",
  "nextWakeAt": "2026-06-13T10:30:00.000Z",
  "scheduledFor": "2026-06-13T10:30:00.000Z",
  "lastHeartbeatAt": "2026-06-13T10:20:00.000Z",
  "checkpointSummary": "Run completed and wrote the release summary.",
  "result": {
    "summary": "Deployment looks healthy."
  },
  "error": {
    "message": "Run failed."
  }
}

Before you start

Platform API

Continue an Agent run

Authorizations

Path Parameters

Body

Response