health.hats.listRequests

The requests waiting on the caller: access asked for their own spaces that policy leaves to them. Authenticated as the patient (service auth), so each patient sees only their own.

Repository @hats.health did:plc:uvvhtareovj2oaregs7vsibv not from the namespace authority
Details · query
Kindquery
Authorityhats.health
Indexed

Query

query · GET

Output

application/json

requests

requiredarray
itemsref
Reference

#request

object

One request, as the coordinator recorded it.

Properties

createdAt

requiredstring · datetime

id

requiredstring

Identifier to answer this request by in answerRequest.

picks

requiredarray

The option ids asked for, from the requester's menu.

itemsstring

requester

requiredref
Reference

#requester

object

Who asked, from the coordinator's provider registry.

Properties

did

requiredstring · did

The institution the requester acts for, as the registry names it.

role

string

NUCC Health Care Provider Taxonomy code.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • health.hats.listGrants

    query not from the namespace authority

    Grants the caller gave, as a patient, and grants the caller holds, as a grantee: one entry per request, newest first. Authenticated by service auth, so each caller sees only their own.

  • health.hats.requestAccess

    procedure not from the namespace authority

    Pick options from the menu for one patient. The coordinator decides by policy and returns, per pick, the space address or pending while a patient or circle approval is outstanding. It never says whether a space holds records; the requester learns that by syncing. Authenticated as the clinician (service auth) and the institution node (client attestation).

  • health.hats.listAsks

    query not from the namespace authority

    Asks the caller made, as a patient, and was asked, as a clinician, newest first. Service auth, so each caller sees only their own.

  • health.hats.listAccessOptions

    query not from the namespace authority

    The menu: what the caller may ask for under a reason. Built only from policy (the requester's role and institution, from authentication, and the reason), never from any patient, so it is the same for every patient.

  • health.hats.answerRequest

    procedure not from the namespace authority

    Approve or decline one waiting request. Approving names the grant record the patient wrote to their health.hats.audit.log space and how long it lasts; the coordinator then grants exactly what was picked, until then. Authenticated as the patient (service auth).