Skip to content

List a Realm's declared consumers

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

The consumers the admitted capture declares and what each reads.

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). 404 when it has no live installation

OK

Media type*/*
Array<object>

One channel consumer a captured realm declares, and the source the owner approved it to read; answered by the /channels/consumers/{realmName} list, grant and revoke routes

object
handler
required

Name of the realm handler the consumer runs

string
handlerApproved
required

Whether that handler is approved on the installation; a consumer cannot be approved until it is

boolean
installationId
required

The live installation of that realm this was read from; send it back as installationId on a change

string
name
required

Name of the consumer, as the realm declares it

string
realmName
required

Name of the realm that declares the consumer

string
revision
required

That installation’s revision; send it back as expectedRevision on a change

integer format: int64
source

The source the consumer is approved to read; null while it is not approved

object
id
required

For host, the host channel’s source id; for realm, the installation id of the realm that produces the source

string
kind
required

One of host (a host channel) or realm (a realm’s event source)

string
realmName

Name of the realm that produces the source; null for a host channel

string
revision
required

For host, the host channel approval’s revision; for realm, the event source grant’s revision, which moves independently of the installation’s revision

integer format: int64
sourceName

Name of the event source within that realm; null for a host channel

string