Skip to content
HALOWERK

Denkwerk

lease lock

Namespaced leases: "acquire" grants the lock to an owner id if it is free or expired and returns a monotonically increasing fencing token; "renew" extends a lease held by the same owner; "release" frees it; "status" shows holder and expiry. TTL 5 seconds to 1 hour. Fencing tokens let downstream systems reject writes from a stale holder. The namespace is claimed with a secret on first use.

POST https://denk.halowerk.com/v1/lease-lock

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
lockstringYes
ownerstringNo
ttl_secondsintegerNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "namespace",
    "secret",
    "action",
    "lock"
  ],
  "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": [
        "acquire",
        "renew",
        "release",
        "status"
      ]
    },
    "lock": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "owner": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 5,
      "maximum": 3600,
      "default": 60
    }
  }
}

Open original schema

Published input example

{
  "namespace": "my-agents",
  "secret": "halowerk-public-catalogue-coordination-v1",
  "action": "acquire",
  "lock": "nightly-report",
  "owner": "worker-7",
  "ttl_seconds": 120
}

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 โ†’