API reference

Contents

• Public evidence
• Workspace
• Flows
• Assessments
• Issues and updates
• Other
• Errors
• Inspection document

Public evidence

Inspect a product the way an agent would discover it. These consume credits when a workspace is metered.

curl -X POST https://app.tansohq.com/v1/interface \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com" }'

curl -X POST https://app.tansohq.com/v1/evaluate \
  -H 'Content-Type: application/json' \
  -d '{ "url": "https://example.com", "task": "Create a test project" }'

curl https://app.tansohq.com/v1/schema

Workspace

Your account, its balance, and everything it has saved. Reading costs nothing.

curl https://app.tansohq.com/v1/account

curl https://app.tansohq.com/v1/runs

curl https://app.tansohq.com/v1/runs/<id>

curl https://app.tansohq.com/v1/execution

curl -X POST https://app.tansohq.com/v1/runs/<id>/resume

curl -X POST https://app.tansohq.com/v1/runs/<id>/cancel

Flows

A saved customer task with the conditions it starts from and the result that counts as success.

curl https://app.tansohq.com/v1/flows

curl -X POST https://app.tansohq.com/v1/flows \
  -H 'Content-Type: application/json' \
  -d '{ "name": "Create first project", "url": "https://example.com", "task": "Create a project", "successCriteria": "A project exists", "access": "public" }'

curl https://app.tansohq.com/v1/flows/<id>/quote

curl -X POST https://app.tansohq.com/v1/flows/<id>/run \
  -H 'Content-Type: application/json' \
  -d '{ "fingerprint": "accepted-quote-fingerprint" }' \
  -H 'Idempotency-Key: <unique-key>'

Assessments

Starting, continuing, and cancelling a bounded agent run.

curl -X POST https://app.tansohq.com/v1/run-requests \
  -H 'Content-Type: application/json' \
  -d '{ "flowId": "flow_..." }'

curl -X POST https://app.tansohq.com/v1/run-requests/<id>/cancel

Issues and updates

Verified failures, the fixes recorded against them, and workspace notifications.

curl https://app.tansohq.com/v1/issues

curl -X PATCH https://app.tansohq.com/v1/issues/<id> \
  -H 'Content-Type: application/json' \
  -d '{ "status": "fix_ready", "note": "What changed" }'

curl https://app.tansohq.com/v1/notifications

curl -X POST https://app.tansohq.com/v1/notifications/<id>/read

Other

curl -X POST https://app.tansohq.com/v1/signup \
  -H 'Content-Type: application/json' \
  -d '{ "label": "my agent" }'

curl https://app.tansohq.com/v1/routes

Errors

Every failure returns JSON with a stable error code and a message written for a person. Read the code, not the message. Codes raised only by the worker or an operator command are omitted; a caller does not receive them.

{ "error": "insufficient_credits", "message": "...", "required": 10, "balance": 3 }

Inspection document

Returned by /v1/interface as agent-ready/interface@1. Every string is either fetched or produced by a named rule; no model-generated text is included.

Conventions

Fields