internal
internal-knowledge

List Knowledge Entries

List a target owner's entries for a scope (user or workspace).

The require_internal injection is redundant with the router-level gate today, but kept for symmetry with the mutating handlers so the read path stays admin-gated even if this router is ever re-mounted standalone.

get/api/v1/internal/knowledge

Request

  • Base URL
    https://api.maia-analytics.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.maia-analytics.com/api/v1/internal/knowledge
  • Auth
    HTTP bearer

Query parameters

scope'user' | 'workspace' required
owner_idstring uuid required

Response

Successful Response

idstring uuid required
scope'user' | 'workspace' | 'project' required

Tier a knowledge entry applies to.

Resolution is additive and ordered user -> workspace -> project — precedence is ordering only, not override (no shadowing in v1). "System" knowledge is the agent's existing system prompt — a separate, pre-existing mechanism that does not live in this table — so there is no system scope here. Project scope (MAIA-2547) is ambient: paths never name a project; the run's project id scopes reads and writes.

user_idstring uuid nullable
workspace_idstring uuid nullable
project_idstring uuid nullable
titlestring required
contentstring required
created_atstring date-time required
updated_atstring date-time required
is_coreboolean required

Whether this is the reserved always-injected core entry (MAIA-2833).

Changes

No recorded changes to this operation across all 30 revisions of this API.