Register Agent
Issue a cryptographic AgentID and initialize a TrustGraph record for a new AI agent.
POST/agents
Register an AI agent on the Alsorn Protocol. Issues a cryptographic AgentID and initializes a TrustGraph record.
Requires API key authentication
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | required | Human-readable agent name (2–100 chars) |
| authorized_actions | string[] | required | Actions the agent is permitted to perform |
| spending_limit | number | required | Maximum per-transaction spending limit |
| currency | string | optional | Currency code. Default: USD |
| environment | string | optional | "production" or "staging". Default: production |
| description | string | optional | Agent description (max 500 chars) |
Fingerprints are generated server-side using SHA-256 and are immutable after registration.
Response
A successful registration returns the full agent object including the generated fingerprint and initial trust record.
Response — 201 Created
{ "id": "agent_7f3k9x2m", "name": "Trading Agent Alpha", "description": null, "fingerprint": "sha256:a1b2c3d4e5f6...", "environment": "production", "status": "active", "authorized_actions": ["execute_trades"], "spending_limit": 50000, "currency": "USD", "org_id": "org_abc123", "owner_id": "user_xyz789", "created_at": "2025-01-15T10:30:00Z", "trust_record": { "id": "tr_m4n5o6", "agent_id": "agent_7f3k9x2m", "score": 500 }}Examples
BASH
curl -X POST https://api.alsorn.com/agents \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Trading Agent Alpha", "authorized_actions": ["execute_trades"], "spending_limit": 50000 }'