Skip to main content
POST
Submit a task for execution

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
prompt
string
required

The prompt/instruction for the LLM

Example:

"Analyze the sentiment of the following text: \"Bitcoin is looking bullish today\""

taskType
enum<string>
required

Type of task. Use evm-action for deterministic EVM state verification.

Available options:
general,
code,
analysis,
creative,
trade_signal,
evm-action
Example:

"analysis"

agentId
string
required

Agent fingerprint ID (unique per agent)

Example:

"agent-alpha-001"

metadata
object

Optional metadata for the task

model
string

Model slug from the whitelist (e.g. "llama-3.3-70b"). Defaults to llama-3.3-70b if omitted. Ignored for evm-action type.

Example:

"llama-3.3-70b"

evmPayload
object

Required when taskType is evm-action. EVM action payload for deterministic verification.

Response

Task executed — provenance receipt returned

taskId
string
status
enum<string>
Available options:
COMPLETED,
UNMETERED,
GUARDRAIL_BLOCKED,
INSUFFICIENT_CREDITS,
COMPUTE_FAILED,
OUTPUT_BLOCKED
agentId
string
model
string
provider
string
latencyMs
number
output
string
ipfsCid
string
stateRoot
string
verificationStatus
string
verificationScore
number
verificationProof
string | null

TX hash from on-chain verification anchor

verificationBasescanUrl
string | null
attestationUid
string | null

EAS Omni-Stamp UID (bytes32 hex)

easscanUrl
string | null

EASScan deep link