Update an Agent inbox item - RevoEngine

PATCH

/

api

/

v1

/

agents

/

{agentId}

/

inbox

/

{agentInboxItemId}

Update an Agent inbox item

curl --request PATCH \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/inbox/{agentInboxItemId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "sync",
  "instruction": "Re-run the customer usage sync for workspace EU-1.",
  "payload": {
    "workspaceId": "eu-1",
    "source": "retry"
  },
  "priority": 500,
  "scheduleFor": "2026-04-12T12:15:00.000Z",
  "dedupeKey": "sync:workspace:eu-1"
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'sync',
    instruction: 'Re-run the customer usage sync for workspace EU-1.',
    payload: {workspaceId: 'eu-1', source: 'retry'},
    priority: 500,
    scheduleFor: '2026-04-12T12:15:00.000Z',
    dedupeKey: 'sync:workspace:eu-1'
  })
};

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

payload = {
    "type": "sync",
    "instruction": "Re-run the customer usage sync for workspace EU-1.",
    "payload": {
        "workspaceId": "eu-1",
        "source": "retry"
    },
    "priority": 500,
    "scheduleFor": "2026-04-12T12:15:00.000Z",
    "dedupeKey": "sync:workspace:eu-1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(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

agentInboxItemId

string

required

Body

application/json

type

string

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

Maximum string length: 128

Example:

"sync"

instruction

string

Instruction that will be passed into the agent run when the item is claimed.

Minimum string length: 1

Example:

"Re-run the customer usage sync for workspace EU-1."

payload

object

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

Example:

{ "workspaceId": "eu-1", "source": "retry" }

priority

number

Queue priority. Higher values are claimed first.

Required range: 0 <= x <= 1000

Example:

500

scheduleFor

Optional updated claim deadline within 30 days of this request.

Example:

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

dedupeKey

string

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

Maximum string length: 255

Example:

"sync:workspace:eu-1"

Response

200

Update an Agent inbox item

curl --request PATCH \
  --url https://api.revoengine.com/api/v1/agents/{agentId}/inbox/{agentInboxItemId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "sync",
  "instruction": "Re-run the customer usage sync for workspace EU-1.",
  "payload": {
    "workspaceId": "eu-1",
    "source": "retry"
  },
  "priority": 500,
  "scheduleFor": "2026-04-12T12:15:00.000Z",
  "dedupeKey": "sync:workspace:eu-1"
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    type: 'sync',
    instruction: 'Re-run the customer usage sync for workspace EU-1.',
    payload: {workspaceId: 'eu-1', source: 'retry'},
    priority: 500,
    scheduleFor: '2026-04-12T12:15:00.000Z',
    dedupeKey: 'sync:workspace:eu-1'
  })
};

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

payload = {
    "type": "sync",
    "instruction": "Re-run the customer usage sync for workspace EU-1.",
    "payload": {
        "workspaceId": "eu-1",
        "source": "retry"
    },
    "priority": 500,
    "scheduleFor": "2026-04-12T12:15:00.000Z",
    "dedupeKey": "sync:workspace:eu-1"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)