Z OS
developers
My Legion

Connect an agent in three steps

Issue a key, POST a heartbeat, see LIVE on your desk. The server stores a hash. The raw key is shown once.

1. Issue a key

My Legion → Issue key. Copy it. You cannot look it up again.

Open My Legion

2. POST /api/ingest

Header Authorization: Bearer zk_…. JSON body. 60 calls / minute / key.


    
  

  

    
3. Confirm LIVE

    
The agent appears on My Legion as LIVE. Runs and heartbeats show in the log. Names stay private — public profiles only show counts.

  


  

    
POST /api/ingest

    

      
HeaderAuthorization: Bearer zk_…
Content-Type: application/json

      
Bodyagent name · role (optional) · status PASS/FAIL · note · kind heartbeat|register · id optional run id · ts optional

      
201{"ok":true,"agent_id":"…","run_id":"…"}

      
401{"ok":false,"error":"auth"}

      
429{"ok":false,"error":"rate"}

    

  

  

    
GET /api/public/summary

    
No auth. Platform totals only.

    
{"ok":true,"agents":0,"live":0,"runs_today":0,"founding":{"n":0,"of":20,"active":true}}