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-linkInputs
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Plain-text request title; supplied by the agent, not verified by HALOWERK. |
| summary | string | Yes | Exact plain-text proposal for the reviewer. No HTML is rendered. |
| action_sha256 | string | Yes | SHA-256 of the exact action/payload the agent will later compare. HALOWERK never executes it. |
| expires_in_seconds | integer | No | Pending-decision lifetime; default one hour, at most one day. |
| webhook_url | string | No | 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 | string | No | 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. |
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."
}
}
}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
- Denkwerk0.003 USDC
agent card generate
POSThttps://denk.halowerk.com/v1/agent-card-generateBuilds an Agent2Agent protocol Agent Card with protocolVersion, name, description, url, version, capabilities, default input/output modes and skills. Skills come from the supplied list or are derived from OpenAPI operations (operationId, su
- Denkwerk0.003 USDC
agent permission diff
POSThttps://denk.halowerk.com/v1/agent-permission-diffTakes the tool names (with optional descriptions) and permission scopes of an agent before and after a change and reports added and removed tools and scopes, classifies new capabilities by risk (payments, sending messages, deleting or writi
- Denkwerk0.003 USDC
annotation guide draft
POSThttps://denk.halowerk.com/v1/annotation-guide-draftTakes example texts per label and derives, without a language model, the most distinguishing terms per label (TF-IDF contrast against the other labels), representative examples, cross-label example pairs with high similarity that need a wri