Beliefs

List beliefs by their free-text (subject, field) key

Beliefs the brain currently holds (semantic_belief, promoted from enriched scenes), filtered by exact subject/field key, lifecycle status (default active) and user scope. A user-bound token is pinned to its own user (userId mismatch is 403); M2M keys may scope to any user or list tenant-wide. Page capped at 100 (default 25). On by default; BELIEFS_API_ENABLED=0 makes it a 404. Source: src/beliefs/beliefs.controller.ts.

Required scope: brain:read.

get/v1/beliefs

Request

  • Base URL: https://brain.inite.ai
  • URL: https://brain.inite.ai/v1/beliefs
  • Auth: HTTP bearer

Query parameters

subjectstring

Free-text subject key (exact match).

fieldstring

Free-text field key (exact match).

userIdstring

End-user scope key. M2M keys may assert any user; user-bound tokens are pinned to their own.

statusstring

Lifecycle filter: active (default), superseded, all.

limitinteger

Page size (default 25, max 100).

Response

The visible beliefs.

foundnumber required

Changes

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