Skip to content
HALOWERK

Denkwerk

idempotency store

Namespaced key/value store for idempotent retries. "begin" claims a key with a payload hash (new, in_progress or completed with the stored result; a different payload under the same key returns a conflict), "complete" stores the result (up to 64 KB) and "get" reads the state. Keys expire after the chosen TTL (max 7 days). The namespace is claimed with a secret on first use and only its HMAC is stored.

POST https://denk.halowerk.com/v1/idempotency-store

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
namespacestringYesYour namespace; claimed by the first call with its secret.
secretstringYesSecret for the namespace (stored only as HMAC).
actionstringYes
keystringYes
payloadSee schemaNoRequest payload; its hash binds the key.
resultSee schemaNoResult to store on complete.
ttl_secondsintegerNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "namespace",
    "secret",
    "action",
    "key"
  ],
  "properties": {
    "namespace": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{3,64}$",
      "description": "Your namespace; claimed by the first call with its secret."
    },
    "secret": {
      "type": "string",
      "minLength": 16,
      "maxLength": 200,
      "description": "Secret for the namespace (stored only as HMAC)."
    },
    "action": {
      "type": "string",
      "enum": [
        "begin",
        "complete",
        "get"
      ]
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "payload": {
      "description": "Request payload; its hash binds the key."
    },
    "result": {
      "description": "Result to store on complete."
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 604800,
      "default": 86400
    }
  }
}

Open original schema

Published input example

{
  "namespace": "my-agents",
  "secret": "halowerk-public-catalogue-coordination-v1",
  "action": "begin",
  "key": "order-4711",
  "payload": {
    "amount": 10
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’