Agents

Claim an agent into an organization

Binds an unclaimed (or legacy hash-claimed) agent to the authenticated caller and an organization. Requires authentication — the caller proves possession of the agent via hash_proof, and the agent's org_id is set to the resolved org (the authz + listing boundary, ADR-062). Supply org_id to claim into a specific org the caller is a member of (role floor: member); omit it to claim into the caller's personal org. Idempotent: re-claiming an agent the caller already owns returns 200 with the resolved org.

post/agents/{agent_id}/claim

Request

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

Path parameters

agent_idstring required

Agent identifier (e.g. smolt-abc123)

Request body

hash_proofstring required

Agent possession proof — either the live birth token (mnbt_…) whose row pins this agent's hash, or the full 64-hex SHA-256 digest of ${apiKey}|${agentName} (or ${apiKey} for an unnamed singleton agent).

org_idstring

Optional. The organization to claim the agent into (e.g. org-... or pers-...). The caller must be a member of this org (role floor: member). If omitted, the agent is claimed into the caller's personal org.

Response

Agent claimed into the resolved organization

claimedboolean required
agent_idstring required
org_idstring required

The organization the agent was claimed into (echoes the resolved org — the supplied org_id, or the caller's personal org when omitted).

claimed_atstring date-time required

Changes

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