API
HTTP API
Use the REST API directly or through an SDK. All task endpoints use JSON.
Authentication
Send your key as x-api-key: rk_test_… or Authorization: Bearer rk_test_….
Base URL: https://api.reineira.xyz
Create a test API key
Console → Developer · Test API keys
Endpoints
POST/v1/declareDeclare an agent's model and scope.
POST/v1/coverReserve funds before a task runs.
POST/v1/settleClose a task with delivery evidence.
POST/v1/recourseRoute a shortfall to recourse.
POST/v1/simulateForce a testnet outcome.
POST/v1/revealReveal an amount with a valid permit.
Example
cURL
curl https://api.reineira.xyz/v1/cover \
-H "content-type: application/json" \
-H "x-api-key: rk_test_…" \
-d '{
"actor":"did:reineira:agent-demo",
"task":"invoice-8842",
"limit":"500.00",
"gate":{"kind":"delivery","config":{}}
}'
Success and error responses are JSON. Errors use { "error": "message" }.