Skip to main content
POST
/
tasks
/
decommitment
Decommitment only
curl --request POST \
  --url https://staging.hdp.api.herodotus.cloud/tasks/decommitment \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "atlantic_query_id": "01KA1F1FY93BP2MWF6BP4Y3GW1",
  "destination_chain_id": "0x534e5f5345504f4c4941",
  "hdp_output": {
    "mmr_metas": [
      {
        "Poseidon": {
          "chain_id": "0xaa37dc",
          "id": "0x30314b345136303433515133424b4d42324e31394d4443595757",
          "root": "0x6e7be7495a7126588df5ce10e090b27ea87357b966cc5b4143d0845ee15af0e",
          "size": "0x2644"
        }
      },
      {
        "Keccak": {
          "chain_id": "0xaa36a7",
          "id": "0x30314a4d484d31413242354d38455336505a57524a505354374d",
          "root_high": "0xb8eb37ccfb5d11f205555666",
          "root_low": "0x8df74acdc8c1fc184081e4a2ec4ccca78c03a541",
          "size": "0x0a813"
        }
      }
    ],
    "output_tree_root_high": "0x109640f2deb15a8d29ee5bb754a2943a",
    "output_tree_root_low": "0xc103b036a12f8f9307b062b11181a726",
    "task_hash_high": "0x89bb92c8c305fd8df0fbcc19602339ac",
    "task_hash_low": "0x56839c1e7f817be047794dbdc727585f"
  },
  "program_hash": "0x34a16478e83f69c4f0bcdb7549d32f92c9b7776bb3f71da06de334f1871eba0",
  "webhook_url": "https://example.com/webhook"
}
'
{
  "message": "Decommitment-only task has been queued",
  "uuid": "01J3Z3K2P4W6M8Q0A1B2C3D4E5"
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json

Decommitment request with Atlantic query ID and optional HDP output data

​
atlantic_query_id
string
required
​
destination_chain_id
string
required

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

​
hdp_output
object
Example:
{
  "mmr_metas": [
    {
      "Poseidon": {
        "chain_id": "0xaa37dc",
        "id": "0x30314b345136303433515133424b4d42324e31394d4443595757",
        "root": "0x6e7be7495a7126588df5ce10e090b27ea87357b966cc5b4143d0845ee15af0e",
        "size": "0x2644"
      }
    },
    {
      "Poseidon": {
        "chain_id": "0x534e5f5345504f4c4941",
        "id": "0x30314a56435052343150314b5759334d45563946594148343853",
        "root": "0x3a2e8b4815132c037baf334416c5585639b250f89dc470893378f9d7ffc18e4",
        "size": "0x153a8a"
      }
    },
    {
      "Keccak": {
        "chain_id": "0xaa36a7",
        "id": "0x30314a4d484d31413242354d38455336505a57524a505354374d",
        "root_high": "0x8df74acdc8c1fc184081e4a2ec4ccca7",
        "root_low": "0x8c03a541b8eb37ccfb5d11f205555666",
        "size": "0x0a813"
      }
    }
  ],
  "output_tree_root_high": "0xc103b036a12f8f9307b062b11181a726",
  "output_tree_root_low": "0x109640f2deb15a8d29ee5bb754a2943a",
  "task_hash_high": "0x56839c1e7f817be047794dbdc727585f",
  "task_hash_low": "0x89bb92c8c305fd8df0fbcc19602339ac"
}
​
program_hash
string | null
​
webhook_url
string | null

Response

Task accepted for decommitment

​
message
string
required
​
status
string
required
​
uuid
string
required