Sign in
tasks

Submit a task for execution

Full 8-stage pipeline: guardrail → credit → compute → verify → anchor → receipt

post/api/v1/tasks/submit

Request body

promptstring required

The prompt/instruction for the LLM

taskType'general' | 'code' | 'analysis' | 'creative' | 'trade_signal' required

Type of task

agentIdstring required

Agent fingerprint ID (unique per agent)

metadataobject

Optional metadata for the task

Example request

{
  "prompt": "Analyze the sentiment of the following text: \"Bitcoin is looking bullish today\"",
  "taskType": "analysis",
  "agentId": "agent-alpha-001"
}

Response

Task executed — provenance receipt returned

taskIdstring
status'COMPLETED' | 'UNMETERED' | 'GUARDRAIL_BLOCKED' | 'INSUFFICIENT_CREDITS' | 'COMPUTE_FAILED' | 'OUTPUT_BLOCKED'
agentIdstring
modelstring
providerstring
latencyMsnumber
outputstring
ipfsCidstring
stateRootstring
verificationStatusstring
verificationScorenumber

Changes