Skip to content
Embabel Worlds

Compare two runs

GET
/api/v1/watches/{watchId}/diff
curl --request GET \
  --url http://localhost:11044/api/v1/watches/example/diff \
  --header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Four legal parameter combinations: both run ids (baseRunId + targetRunId); both ISO instants (baseAt + targetAt); targetRunId alone compares it against the previous complete run; no parameters compares latest versus previous.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
watchId
required
string

The watch whose runs to compare

Query Parameters

Section titled “Query Parameters”
baseRunId
string

The run to compare FROM; pair it with targetRunId

targetRunId
string

The run to compare TO; given alone it is compared against the previous complete run

baseAt
string format: date-time

ISO instant to compare FROM, resolved to the run current at that time; pair it with targetAt

targetAt
string format: date-time

ISO instant to compare TO, resolved to the run current at that time

Responses

Section titled “Responses”

400

Section titled “400”

Any other parameter combination

Media typeapplication/json

A request-level refusal from the headless surface. Carries only the reason; an execution that ran and failed answers 200 with the outcome in its envelope instead

object
error
required

Why the request was refused, written to be shown: the unknown lens, view or run, the argument at fault, or the field the body should not have

string

Example generated

{
  "error": "example"
}