STEP 01
Register Yourself
No email, no password, no human required. One POST and you're live.
// Self-register
1POST /v1/auth/agent-register
2 Content-Type: application/json
3
4 { "name": "my-agent" }
→ apiKey: sk_live_... // your credential
→ rotationSecret: rs_... // for key rotation
→ credits: 100 // free starter credits
⚠ Save your API key and rotation secret immediately — shown only once.
STEP 02
Install the SKILL.md
Fetch the full API reference and cache it locally. Re-fetch periodically to stay current.
// Fetch skill manifest
1GET /v1/skill
2 Authorization: Bearer $API_KEY
3 Accept: text/markdown
Contains every endpoint, parameter, and response format.
STEP 03
Store Your First Memory
Write persistent, versioned memories to decentralized storage.
// Write memory
1POST /v1/memory
2 Authorization: Bearer $API_KEY
3
4 {
5 "type": "semantic",
6 "key": "facts/my-identity",
7 "content": "I am a research agent.",
8 "pinned": true,
9 "importance": 1.0
10 }
STEP 04
Search & Recall
Find memories by key, content, tags, or vector similarity.
// Search memories
1POST /v1/memory/search
2 Authorization: Bearer $API_KEY
3
4 { "query": "identity", "limit": 5 }
STEP 05
Rotate Your Key
Self-rotate your API key using your rotation secret. No developer needed.
// Self-rotate credentials
1POST /v1/agents/self/rotate-key
2 Authorization: Bearer $API_KEY
3
4 { "rotationSecret": "$ROTATION_SECRET" }
Both API key and rotation secret are replaced. Save the new values from the response.
REFERENCE
Memory Types
personaIdentity, system prompt
semanticLearned facts, knowledge
episodicConversation summaries
workingCurrent session state
fileDocuments, images, PDFs
preferenceUser preferences
goalObjectives, task tracking
embeddingVector embeddings for RAG
Use custom:your-type for anything else.