Skip to content

Revoke one declared watch

POST
/api/v1/realms/{realmName}/watch-approvals/{watch}/revoke
curl --request POST \
--url http://localhost:11044/api/v1/realms/example/watch-approvals/example/revoke \
--header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

JSON fields: installationId, expectedRevision. Its schedule stops.

realmName
required
string

Name of the admitted realm whose watch approval is withdrawn; the body’s installationId and expectedRevision must name its current installation, or the change answers 409

watch
required
string

Name of a watch the realm’s admitted capture declares, as the list route returns it; an undeclared name answers 400, and one not currently approved 409

OK

Media type*/*

A captured realm’s declared watches and their approvals, as GET /realms/{realmName}/watch-approvals and the grant and revoke routes answer, with the installation and revision the next change must name back

object
digest
required

Digest of the realm content this installation admitted

string
installationId
required

The realm installation the watches belong to; a grant or revoke must send it back

string
revision
required

The installation’s revision, after the change on a grant or revoke; the next grant or revoke must send it back as expectedRevision

integer format: int64
watches
required

Every watch the admitted realm declares, each with whether it is approved

Array<object>

One watch a captured realm declares: the lens it re-reads, its cron schedule, and whether the owner has approved it

object
approved
required

True when the owner has approved this watch, so its schedule runs; approving it grants nothing on the lens or its handler

boolean
lens
required

Id of the realm’s own lens the watch re-reads

string
schedule
required

Cron expression it re-reads the lens on, already checked against the host’s minimum interval

string
watch
required

The watch’s name, as the grant and revoke routes take it

string