Agents

Register a new agent

Register a new agent with a name and hash proof. Optionally attach an alignment card and policy.

post/agents

Request

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

Request body

namestring required

Agent name. 2-32 characters, alphanumeric and hyphens only, must start and end with alphanumeric.

hash_proofstring required

SHA256 hex string used to derive the agent ID and hash.

card_jsonobject

Optional alignment card JSON to attach on creation.

policy_yamlstring

Optional YAML policy string to create alongside the agent.

Example request

{
  "name": "my-agent",
  "hash_proof": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"
}

Response

Agent registered successfully

idstring

Agent ID (e.g. smolt-abc12345)

agent_hashstring

First 16 characters of the hash_proof

namestring
created_atstring date-time
card_idstring

ID of the created alignment card

policy_createdboolean

Whether a policy was created from the provided policy_yaml

Example response

{
  "id": "smolt-a1b2c3d4"
}

Changes

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