Monitor any bot that can send an HTTPS request

POST https://app.robovue.co.uk/ingest/{tenantId}/runs

The endpoint both SDKs call, and the one to use from any other language.

Headers

Content-Type Required

application/json

The body is JSON. A charset parameter is fine.

X-Robovue-Delivery-Id Required

1–200 printable ASCII characters, no spaces

Unique to this run. Sending it again updates or confirms the same run instead of creating a second one, as a retry does, or the Success or Failure that ends a Running run. A GUID or your bot’s own run ID both work. It cannot start with "uipath-job-" or "automation-anywhere-", because Robovue uses those for runs it receives from UiPath and Automation Anywhere.

X-Robovue-Timestamp Required

Unix time in whole seconds

When you signed the request. It must be within 5 minutes of Robovue’s clock either way, so a captured request stops working within minutes. Sign each attempt just before sending it, retries included.

X-Robovue-Signature Required

v1=<lowercase hex>

An HMAC-SHA256 keyed with your webhook secret. Sign the timestamp, the word run and the delivery ID, each followed by a line break, then the exact request body. Encode it as lowercase hex and put v1= in front. Sign the exact bytes you send, because re-serialising the JSON after signing changes them. Several comma-separated v1= values are accepted, and any one matching is enough.

X-Robovue-Dry-Run Optional

true

Checks the request exactly as a real one would be checked, including authentication, every field, the delivery ID and your plan’s bot limit, and stores nothing. The response says what would have happened. Use it to test an integration without creating runs. Any other value, or no header, is an ordinary request.

Body

A JSON object with the fields below.

botId string, up to 200 characters Required

Your name for the bot. Every run with the same botId belongs to the same bot in Robovue. Spaces and punctuation are fine, but not / or \. It cannot start or end with a space, or contain tabs or line breaks. The same ID registers and manages the bot through the Management API.

For example invoice-bot-01

platform string, up to 50 characters Required

What runs the bot, shown beside it in Robovue. Any short label works, such as dotnet, python, go or blue-prism. The same space and line break rules as botId apply.

For example python

status string Required

How the run went. Running reports a run that has started and not finished yet. When it ends, send the same delivery ID again with Success or Failure. Values are case-sensitive.

One of Success Failure Running

For example Success

startedAt timestamp Required

When the run started, as an RFC 3339 timestamp with a time zone offset: Z for UTC, or ±hh:mm. For example, 2026-07-17T09:00:00Z. It cannot be before 2000, or more than an hour ahead of Robovue’s clock. Unix times are not accepted.

For example 2026-07-17T09:00:00Z

completedAt timestamp Sometimes

Required when status is Success or Failure; leave it out when status is Running

When the run finished. It has the same format and limits as startedAt, and cannot be before it.

For example 2026-07-17T09:01:30Z

failureCategory string Optional

Only with status Failure

Why the run failed, if your bot can tell. If it cannot, leave it out: the run is recorded as Uncategorized, and you can change that later on the run’s page. Values are case-sensitive.

One of Uncategorized BusinessException ApplicationException Timeout AuthenticationError Cancelled

For example ApplicationException

payload object Optional

Anything that will help you debug the run later, such as an invoice number, the step that failed or a stack trace. It must be a JSON object, and it’s stored as sent and shown on the run’s page. A top-level error, errorMessage or message string becomes the summary in the failure alert. It counts toward the 64 KB request limit.

For example { "invoiceId": "INV-2291", "error": "Timed out waiting for the vendor portal" }