---
title: "Submit a task for execution"
method: POST
path: "/api/v1/tasks/submit"
tags: ["tasks"]
---

# Submit a task for execution

`POST /api/v1/tasks/submit`

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

## Request body

- object
  - `prompt` string, required — The prompt/instruction for the LLM
  - `taskType` 'general' | 'code' | 'analysis' | 'creative' | 'trade_signal', required — Type of task
  - `agentId` string, required — Agent fingerprint ID (unique per agent)
  - `metadata` object — Optional metadata for the task

## Response `200`

Task executed — provenance receipt returned

- object
  - `taskId` string
  - `status` '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

## Other responses

- `400` — Invalid request body or guardrail block
- `401` — Missing or invalid JWT

## Changes

- **2026-03-14** `bcb7c5bf7ca6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/changes/api/v1/tasks/submit/post.md)

---

[API](https://skmtc.dev/humbleaf/apis/agentchain-prior-api.md) · [All operations](https://skmtc.dev/humbleaf/apis/agentchain-prior-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humbleaf/agentchain-prior-api/revisions/bcb7c5bf7ca6/schema)