Skip to main content
POST
/
agents
Register a new agent
curl --request POST \
  --url https://api.mnemom.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "my-agent",
  "hash_proof": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "card_json": {},
  "policy_yaml": "<string>"
}
'
{
  "id": "smolt-a1b2c3d4",
  "agent_hash": "<string>",
  "name": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "card_id": "<string>",
  "policy_created": true
}

Authorizations

​
Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Body

application/json
​
name
string
required

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

Required string length: 2 - 32
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9-]{0,30}[a-zA-Z0-9]$
Example:

"my-agent"

​
hash_proof
string
required

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

Minimum string length: 16
Example:

"a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2"

​
card_json
object

Optional alignment card JSON to attach on creation.

​
policy_yaml
string

Optional YAML policy string to create alongside the agent.

Response

Agent registered successfully

​
id
string

Agent ID (e.g. smolt-abc12345)

Example:

"smolt-a1b2c3d4"

​
agent_hash
string

First 16 characters of the hash_proof

​
name
string
​
created_at
string<date-time>
​
card_id
string

ID of the created alignment card

​
policy_created
boolean

Whether a policy was created from the provided policy_yaml