Agents

Get agent by ID

get/agents/{agent_id}

Request

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

Path parameters

agent_idstring required

Agent identifier (e.g. smolt-abc123)

Response

Agent details. Members of the agent's org (any role) get the full record with caller: "org_member"; everyone else, signed in or not, gets a fixed public projection (id, name, claimed, status, avatar_url, created_at) with caller: "authenticated" or "anonymous". The correction-history lists serve non-members a redacted view; the other /agents/{agent_id}/… reads are org-member only unless their own description says otherwise.

idstring
claimedboolean

Public projection only: whether the agent has been claimed by a user.

avatar_urlstring nullable
claimed_bystring nullable

Owner projection: user id that claimed the agent.

created_bystring nullable

Owner projection: user id that created the agent (provenance).

org_idstring nullable

Owner projection: the agent's org binding (ADR-062 authz boundary).

agent_proof_hashstring nullable

Owner projection: captured hash_proof of the bound key (mig 263).

agent_proof_captured_atstring date-time nullable
deleted_atstring date-time nullable

Owner projection: soft-delete timestamp (null when live).

agent_hashstring

First 16 hex chars of SHA256(apiKey + '|' + agentName) for named agents, or SHA256(apiKey) for unnamed singleton agents. The gateway computes the same value on each request and uses it as the lookup key. See Agent Identity.

user_idstring nullable
emailstring nullable
claimed_atstring date-time nullable
last_seenstring date-time nullable
namestring nullable

Agent name (2-32 chars, alphanumeric + hyphens). Present on all list and get responses.

containment_status'active' | 'paused' | 'killed' nullable

Containment state of the agent (ADR-053).

key_prefixstring nullable

First 8 chars of the bound API key hash — useful for key-rotation debugging.

status'active' | 'offline'
caller'anonymous' | 'authenticated' | 'org_member'

Self-describing caller context for THIS response. org_member callers receive the full owner record (all fields here); anonymous/authenticated (non-member) callers receive the reduced public projection (id, name, claimed, created_at, last_seen, status, avatar_url, caller). The differing field set is GOVERNED by this value — read it instead of inferring why a field is absent.

publicboolean

Identity-record visibility axis — whether the agent's IDENTITY RECORD is publicly discoverable. This is DISTINCT from reputation visibility: every registered agent's reputation is public by accountability standard (see ReputationScore.visibility). public here governs only the identity record, never the Trust Rating.

aip_enforcement_mode'observe' | 'enforce' | 'nudge' nullable
billing_account_idstring nullable
created_atstring date-time

Example response

{
  "agent_hash": "a1b2c3d4e5f6a7b8"
}

Changes

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