Disclosures

Record that something was told to an audience

The manual counterpart to recall's automatic accounting: a briefing given in a room, a filing mailed, a call made. The response's disclosure is the ONLY handle that can later amend, clarify or notice this thread — a client that drops it has recorded a telling it can never annotate.

This ledger records that SPEECH OCCURRED to an audience. It does not record — and nothing in this API implies — that the audience received, read, understood or acted on it. Receipt is unknowable from here; an acknowledgement record is a possible future addition and v1 does not pretend.

Audiences are EXACT: telling entity:HASC is not telling entity:Congress, and no fold widens one into the other. Membership resolution is an advisory port with no verb yet.

There is no delete and no revoke. The nearest thing is a RETRACTED NOTICE, which coexists with the disclosure it names: telling someone a thing was wrong is more speech, not less.

Requires the coord:write scope. Accepts all three lanes: a session JWT (bounded by the caller's role on this workspace) or an il_* machine credential whose own scope set, workspace set and validity window cover it — both ceilings apply and neither can raise the other, so a credential carrying coord:write is still refused where the role does not permit it.

A credential with no scope record resolves to LEGACY_DEFAULT, which does NOT include coord:write — mint a key with it explicitly (POST /v2/workspaces/{id}/keys).

post/v2/workspaces/{id}/disclosures

Request

  • Base URL: https://api.infolang.ai
  • URL: https://api.infolang.ai/v2/workspaces/{id}/disclosures
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required

Request body

audiencestring required
channelstring required
disclosurestring uuid
memory_idstring

Response

The recorded telling

disclosurestring required
channelstring required
recordstring required
authoritystring required
appendedboolean required
indexedboolean required
index_reasonstring

Changes

No recorded changes to this operation across all 1 revision of this API.