API Reference

Create a mandate (TypeScript)

import AGLedger from '@agledger/sdk'

const client = new AGLedger({ baseUrl: 'https://your-instance.example.com' })

// Create a mandate — lock the agreement before work starts
const mandate = await client.mandates.create({
  contractType: 'deliverables',
  principal: { name: 'ops-team', role: 'principal' },
  performer: { name: 'agent-claude', role: 'performer' },
  criteria: {
    task: 'Generate quarterly compliance report',
    deadline: '2026-04-30T00:00:00Z',
    constraints: { format: 'PDF', maxPages: 25 }
  }
})

// Agent submits receipt with evidence
const receipt = await client.receipts.create(mandate.id, {
  evidence: {
    deliverable: 'https://storage.example.com/report-q1.pdf',
    pages: 18,
    generatedAt: new Date().toISOString()
  }
})

// Principal renders verdict
const verdict = await client.verdicts.create(mandate.id, {
  decision: 'ACCEPTED',
  notes: 'Report meets all criteria'
})

Same flow with curl

# Create mandate
curl -X POST https://your-instance.example.com/api/v1/mandates \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contractType": "deliverables",
    "principal": { "name": "ops-team" },
    "performer": { "name": "agent-claude" },
    "criteria": { "task": "Generate quarterly report" }
  }'

# Submit receipt
curl -X POST .../api/v1/mandates/{id}/receipts \
  -H "Authorization: Bearer $API_KEY" \
  -d '{ "evidence": { "deliverable": "https://..." } }'

# Render verdict
curl -X POST .../api/v1/mandates/{id}/verdicts \
  -H "Authorization: Bearer $API_KEY" \
  -d '{ "decision": "ACCEPTED" }'