Create an Agent inbox item - RevoEngine

POST

/

api

/

v1

/

agents

/

{agentId}

/

inbox

Create an Agent inbox item

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/inbox \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instruction": "Investigate the failed nightly billing export."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({instruction: 'Investigate the failed nightly billing export.'})
};

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

payload = { "instruction": "Investigate the failed nightly billing export." }
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 that will be passed into the agent run when the item is claimed.

Minimum string length: 1

Example:

"Investigate the failed nightly billing export."

type

string

Logical task type such as task, incident, sync, or concierge_message.

Maximum string length: 128

Example:

"incident"

payload

object

Opaque task payload persisted with the inbox item and copied into the run state.

Example:

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

priority

number

Queue priority. Higher values are claimed first.

Required range: 0 <= x <= 1000

Example:

900

scheduleFor

Optional claim deadline within 30 days of acceptance. The inbox item is recorded immediately.

Example:

"2026-04-12T12:00:00.000Z"

dedupeKey

string

Optional de-duplication key unique per agent among non-terminal inbox items.

Maximum string length: 255

Example:

"incident:INC-421"

Response

201

Create an Agent inbox item

curl --request POST \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/inbox \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instruction": "Investigate the failed nightly billing export."
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({instruction: 'Investigate the failed nightly billing export.'})
};

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

payload = { "instruction": "Investigate the failed nightly billing export." }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)