Skip to content

Revoke one resource

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

JSON fields: installationId, expectedRevision. The next query that needs it is refused.

realmName
required
string

Name of the captured realm installed in the signed-in owner’s world; non-blank, at most 256 UTF-8 bytes, no control characters and not all * (400 otherwise). 409 when its live installation is not the one named by the body’s installationId and expectedRevision

resource
required
string

Resource to revoke: cypher_query for the graph read, or view:<alias> for a view alias the realm declares, as the approval list gives them. 400 for anything else, 409 when it is not approved

OK

Media type*/*

A captured realm’s resource approvals: the graph read and each view alias it declares. Answered by listing them and by each grant or revoke

object
digest
required

The digest of the realm content this installation admitted, 64 lowercase hex characters

string
installationId
required

The live installation’s id, a UUID. A grant or revoke names it back

string
resources
required

Every resource the installation could be granted, the graph read first and then each declared view alias

Array<object>

One thing a captured realm may be granted to read, and whether the owner has granted it

object
approved
required

Whether the installation holds this grant now

boolean
description
required

The sentence the owner is shown for this resource, saying what granting it lets the realm read

string
resource
required

The resource’s name, as the grant and revoke paths take it: “cypher_query” for the graph read, or “view:” followed by a declared alias for a named view

string
revision
required

The installation’s admission revision after this read or change. A grant or revoke names it back as expectedRevision, and is refused if the installation has moved on

integer format: int64