Schedule a new task

Creates a new Data Processor task of verified custom module execution with Atlantic submission and on-chain commitment. The task will be queued for processing through the HDP pipeline: dry run, chain proofs fetch, trace generation, Atlantic proving, and finally on-chain decommitment.

POST /tasks

Schedule a new task

cURL

curl --request POST \
  --url https://staging.hdp.api.herodotus.cloud/tasks \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "destination_chain_id": "0x534e5f5345504f4c4941",
  "input": {
    "compiled_class": {
      "bytecode": [
        "0x480680017fff8000",
        "0x1",
        "..."
      ],
      "bytecode_segment_lengths": [
        100
      ],
      "compiler_version": "2.6.0",
      "entry_points_by_type": {
        "CONSTRUCTOR": [],
        "EXTERNAL": [
          {
            "builtins": [
              "range_check",
              "pedersen"
            ],
            "offset": 0,
            "selector": "0x362398bec32bc0ebb411203221a35a0301193a96f317ebe5e40be9f60d15320"
          }
        ],
        "L1_HANDLER": []
      },
      "hints": [],
      "prime": "0x800000000000011000000000000000000000000000000000000000000000001",
      "pythonic_hints": []
    },
    "injected_state": {},
    "params": [
      "0x1234",
      "0x5678",
      "0x9abc"
    ]
  },
  "program_hash": "0x34a16478e83f69c4f0bcdb7549d32f92c9b7776bb3f71da06de334f1871eba0",
  "task_inputs": [
    {
      "value": "0x1234",
      "visibility": "public"
    },
    {
      "value": "0x5678",
      "visibility": "private"
    }
  ],
  "webhook_url": "https://example.com/webhook"
}
'

202

{
  "message": "Task has been queued",
  "uuid": "01J3Z3K2P4W6M8Q0A1B2C3D4E5"
}

Authorizations

X-API-KEY · string · header · required

Body

application/json

Task creation request with destination chain, compiled module, and execution parameters

destination_chain_id · string · required

Hex chain ID string (e.g., "0xa4b1", "0xaa36a7")

input · object · required

herodotus_cloud_api_key · string | null

injected_state_server · string | null

is_atlantic_mock_hash · boolean | null

is_mock · boolean | null

program_hash · string | null

schedule_mode · string | null

schedule_tx_hash · string | null

task_inputs · any

webhook_url · string | null

Response

202

application/json

Task has been queued for processing

message · string · required

status · string · required

uuid · string · required