Code

Live goal state of one Mnemom Agent session

Backs mnemom agent show. Resolves the org like GET /v1/code/entitlement (explicit org_id else the caller's primary org), requires membership, and confirms agent_id belongs to that org — an unknown agent and an agent in another org are the SAME 404 agent_not_found, so existence never leaks across tenants. Then relays the gateway's state for conversationId verbatim: the sealed goal contract (sealed, with the gateway's hash — the only sealed hash; a locally computed one differs because the gateway normalises absent arrays), the latest alignment verdict, the turn counter, the guardrail ceilings/state, the seal lifecycle (seal), the last-50 verdict trail (verdict_trail) and the judging counts (unjudged_turns/memoised_turns). null/[] sections mean the gateway holds nothing for that conversation (absence is data, never a 404); the same is true of a session sealed before these fields existed on an older gateway. 503 gateway_unavailable when the gateway is unset or unreachable.

get/agent/sessions/{conversationId}

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/agent/sessions/{conversationId}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Mnemom-Api-Key
    • API key in cookie mnemom_session

Path parameters

conversationIdstring required

The conversation id the CLI launched the session with.

Query parameters

agent_idstring required

The agent record id (agents.id) the session ran as.

org_idstring

Target organization (defaults to the caller's primary org).

Response

The session's live goal state. Every gateway-owned section is nullable — a session that never sealed a goal contract returns sealed: null, verdict: null, turn: null, guardrails: null.

conversation_idstring required
org_idstring required
turninteger nullable required

Turns the gateway has counted for this conversation.

unjudged_turnsinteger nullable required

Assistant turns under the current seal with no verdict (a cut-off/aborted response, a judge that failed or never ran, a non-streamed final turn). null when no judge ledger counts under the current seal.

memoised_turnsinteger nullable required

Turns the judge memo graded without re-running the judge — inherited from a prior turn judged aligned under the same contract version with a matching tool-call shape and text. null alongside unjudged_turns.

Changes

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