> For the complete documentation index, see [llms.txt](https://docs.konnex.world/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnex.world/sdk/http.md).

# HTTP API

JSON over HTTPS. Base URL and authentication match your deployment and the same settings you use for the CLI.

## Submit task

POST `/api/v1/tasks`

```json
{
  "subnet": "sn.roboarm.sim",
  "prompt": "dice tomatoes and place into pan",
  "rewardStable": 12.5,
  "stakeStable": 5,
  "deadline": 120
}
```

## Register miner model

POST `/api/v1/miners/models`

```json
{
  "subnet": "sn.roboarm.sim",
  "modelUri": "ipfs://.../policy.wasm",
  "kpi": {"success": ">=0.98", "time_s": "<=120"},
  "stakeStable": 10
}
```

## Validator verify bundle

POST `/api/v1/validators/verify`

```json
{ "jobId": "...", "bundleUri": "s3://bucket/powp.zip" }
```