Agents

Move an agent to another organization (admin-in-both)

Role-based agent relocation between organizations. The caller must be an owner/admin of BOTH the agent's current (source) org and the destination org — this is the role-based counterpart to re-claim, which relocates by proof of possession (hash_proof); move never needs the agent's key. Personal↔company moves are allowed under the same rule. Side effects mirror claim's org-reassignment: billing/quota recompute, canonical-card recomposition (the destination org's template can floor/cap composed values, so the agent's effective posture may change), and source-org team memberships are closed. Every move writes an agent.org_moved governance audit row. Mutations require an Idempotency-Key header. Moving to the agent's current org is an idempotent no-op (moved: false).

post/agents/{agent_id}/move

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/agents/{agent_id}/move
  • 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

dest_org_idstring required

The organization to move the agent into (e.g. org-... or pers-...). The caller must be an owner/admin of this org AND of the agent's current org.

Response

Agent moved to the destination organization (or already there — idempotent no-op with moved: false)

movedboolean required

true when the agent's org changed; false when it was already in the destination org (idempotent no-op).

agent_idstring required
from_org_idstring required
to_org_idstring required

Changes

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