Reference

API

The sandbox REST API.

The API lives at https://dapp.covergate.app/api/v1. Requests and responses are JSON. Errors return { "error": "..." } with a matching status code.

Gateway and decisions#

Method	Path	Purpose
POST	`/gateway`	Run a transaction through both gates. Set `dryRun` to `true` to skip execution.
GET	`/decisions`	List decisions
POST	`/decisions/:id/approve`	Approve a pending decision
POST	`/decisions/:id/reject`	Reject a pending decision
POST	`/receipts/verify`	Check a receipt against its record
GET	`/receipts/key`	The public key that signs receipts

Agents and mandates#

Method	Path	Purpose
GET	`/overview`	Totals for the dashboard
GET	`/agents`	List agents
POST	`/agents`	Create an agent from a mandate template
GET	`/agents/:id`	One agent, with its cover, mandates, and decisions
POST	`/agents/:id/freeze`	Freeze or unfreeze
POST	`/agents/:id/session`	Revoke or restore the session key
POST	`/agents/:id/mandates`	Save a new mandate version
GET	`/agents/:id/export.csv`	Export an agent's decisions
GET	`/mandate-templates`	List mandate templates
GET	`/agents/:id/webhooks`	List webhooks and recent deliveries
POST	`/agents/:id/webhooks`	Add a webhook. The signing secret is returned once.
POST	`/webhooks/:id/delete`	Remove a webhook

Certificates#

Method	Path	Purpose
GET	`/certificates`	List certificates
POST	`/certificates/validate`	Check a signed certificate without registering it
POST	`/certificates`	Register a signed certificate
POST	`/certificates/:id/revoke`	Revoke a certificate
POST	`/sandbox/certificates`	Get a test certificate for your own agent

Claims and alerts#

Method	Path	Purpose
GET	`/claims`	List claims
POST	`/claims`	Open a claim
POST	`/claims/:id/advance`	Move a claim forward. Send `{ "reject": true }` to reject it.
GET	`/claims/:id/evidence`	Download a claim's evidence pack
GET	`/alerts`	List alerts
POST	`/alerts/:id/read`	Mark an alert as read

Public#

Method	Path	Purpose
GET	`/public/agents/:slug`	Counterparty check
GET	`/public/agents/:slug/badge.svg`	Coverage badge image

Create an agent#

bash

curl -X POST https://dapp.covergate.app/api/v1/agents \
  -H "content-type: application/json" \
  -d '{
    "name": "Invoice Agent",
    "operator": "Your team",
    "template": "payments",
    "destinations": ["<destination>"]
  }'

The response is { "id": "...", "slug": "..." }.