HALOWERKAgentenwerk
webhook inbox
Gives an agent without a reachable server a place to receive callbacks. create returns a public URL that accepts any POST, GET or PUT from a third party; poll returns the events that arrived since a cursor you carry forward, with headers, parsed body and arrival time. The inbox expires after at most seven days and holds at most 500 events, oldest dropped first. Reading requires the secret returned at creation.
POST https://agent.halowerk.com/v1/webhook-inboxEingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| action | string | Ja | create makes a new inbox, poll reads events, delete removes it. |
| inbox_id | string | Nein | Required for poll and delete. |
| secret | string | Nein | The secret returned by create. Required for poll and delete. |
| cursor | integer | Nein | Only events with a higher sequence number are returned. |
| limit | integer | Nein | Maximum events per poll. |
| ttl_seconds | integer | Nein | Lifetime of a new inbox, at most seven days. |
| max_events | integer | Nein | How many events the inbox keeps before dropping the oldest. |
| note | string | Nein | Free label carried through. |
Vollständiges Eingabeschema anzeigen
{
"type": "object",
"required": [
"action"
],
"additionalProperties": false,
"properties": {
"action": {
"type": "string",
"enum": [
"create",
"poll",
"delete"
],
"description": "create makes a new inbox, poll reads events, delete removes it."
},
"inbox_id": {
"type": "string",
"minLength": 8,
"maxLength": 64,
"description": "Required for poll and delete."
},
"secret": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"description": "The secret returned by create. Required for poll and delete."
},
"cursor": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Only events with a higher sequence number are returned."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50,
"description": "Maximum events per poll."
},
"ttl_seconds": {
"type": "integer",
"minimum": 60,
"maximum": 604800,
"default": 3600,
"description": "Lifetime of a new inbox, at most seven days."
},
"max_events": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 100,
"description": "How many events the inbox keeps before dropping the oldest."
},
"note": {
"type": "string",
"maxLength": 200,
"description": "Free label carried through."
}
}
}Veröffentlichtes Eingabebeispiel
{
"action": "create",
"cursor": 0,
"limit": 50,
"ttl_seconds": 3600,
"max_events": 100
}Ergebnis & Dokumentation
Veröffentlichtes Ergebnisschema anzeigen
{
"$ref": "https://agent.halowerk.com/v1/webhook-inbox/schema#/outputSchema"
}Veröffentlichtes Ergebnisbeispiel öffnen
Maschinenlesbare Dokumentation dieses Hubs
Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.
Weitere Endpunkte dieses Hubs
- Agentenwerk0,002 USDC
a2a card validate
POSThttps://agent.halowerk.com/v1/a2a-card-validateValidates an Agent Card document against the A2A convention and returns findings by severity: error (the card is unusable as published), warning (works, but a consuming agent will guess), info (recommended field absent).
- Agentenwerk0,003 USDC
artifact receipt
POSThttps://agent.halowerk.com/v1/artifact-receiptSeal binds an exact UTF-8 content SHA-256 digest and expiry to a HALOWERK Ed25519 signature; verify checks signature, expiry and optional exact content. The service public key is included. This attests digest receipt only, not truth, legal
- Agentenwerk0,001 USDC
base64 codec
POSThttps://agent.halowerk.com/v1/base64-codecConverts text to padded standard Base64 or decodes canonical Base64 to valid UTF-8. Rejects noncanonical padding, whitespace, URL-safe alphabet and invalid decoded UTF-8.