Skip to content
HALOWERK

Denkwerk

human approval link

Creates a SQLite-backed request with separate random approval and read-only status tokens. The reviewer opens the private fragment link, reads the plain-text proposal and SHA-256 fingerprint, explicitly confirms review and records approve/reject. Decisions cannot be replaced. POST approval_id and status_token to the returned status_url for free polling. Optional HTTPS webhook requires an exact origin-hosted ownership proof and a private secret; delivery rechecks ownership, sends.

POST https://denk.halowerk.com/v1/human-approval-link

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
titlestringYesPlain-text request title; supplied by the agent, not verified by HALOWERK.
summarystringYesExact plain-text proposal for the reviewer. No HTML is rendered.
action_sha256stringYesSHA-256 of the exact action/payload the agent will later compare. HALOWERK never executes it.
expires_in_secondsintegerNoPending-decision lifetime; default one hour, at most one day.
webhook_urlstringNoOptional public HTTPS receiver on port 443; no query/fragment/credentials. Its origin must publish /.well-known/halowerk-approval-webhook.json with exactly {version:1,webhook_url:<canonical URL>,secret_sha256:<SHA-256 of webhook_secret>}.
webhook_secretstringNoPrivate random base64url secret, at least 32 random bytes. Publish only its SHA-256 in the ownership proof; this secret signs timestamp + dot + raw webhook JSON using HMAC-SHA256.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "title",
    "summary",
    "action_sha256"
  ],
  "dependencies": {
    "webhook_url": [
      "webhook_secret"
    ],
    "webhook_secret": [
      "webhook_url"
    ]
  },
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "description": "Plain-text request title; supplied by the agent, not verified by HALOWERK."
    },
    "summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Exact plain-text proposal for the reviewer. No HTML is rendered."
    },
    "action_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "SHA-256 of the exact action/payload the agent will later compare. HALOWERK never executes it."
    },
    "expires_in_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "default": 3600,
      "description": "Pending-decision lifetime; default one hour, at most one day."
    },
    "webhook_url": {
      "type": "string",
      "maxLength": 1500,
      "description": "Optional public HTTPS receiver on port 443; no query/fragment/credentials. Its origin must publish /.well-known/halowerk-approval-webhook.json with exactly {version:1,webhook_url:<canonical URL>,secret_sha256:<SHA-256 of webhook_secret>}."
    },
    "webhook_secret": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43,128}$",
      "description": "Private random base64url secret, at least 32 random bytes. Publish only its SHA-256 in the ownership proof; this secret signs timestamp + dot + raw webhook JSON using HMAC-SHA256."
    }
  }
}

Open original schema

Published input example

{
  "title": "Approve a draft release",
  "summary": "Review release build 42 before the agent publishes it. HALOWERK only records the decision.",
  "action_sha256": "19a755cb566026f4040898aa50b59145cb2f09d1bd4b4cebb0882e2f2501dbf7"
}

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