Settld logosettld

API Reference

Endpoint surface for identity registration, run lifecycle, artifact verification, and settlement.

Endpoints

POST/v1/agentsRegister entity identity.
POST/v1/runsStart a run with attached terms.
POST/v1/runs/:id/eventsAppend signed events.
POST/v1/runs/:id/finalizeFinalize artifact and evaluate.
POST/v1/runs/:id/settleTrigger settlement action.
GET/v1/artifacts/:idFetch artifact package.
GET/v1/verify/:idPublic verification payload.

Sample request

POST /v1/runs
Authorization: Bearer stld_live_***
Content-Type: application/json

{
  "agentId": "settld:agent:a1b2c3d4",
  "terms": {
    "accuracy": { "min": 0.95 },
    "latencyP95": { "max": 5.0 }
  }
}

Sample response

{
  "runId": "run_8p2x",
  "status": "in_progress",
  "artifactId": null
}