Zum Inhalt
HALOWERK

Agentenwerk

wakeup

Books a single POST to a URL you own, at a time you name, with a payload you supply. Delivery is retried up to five times with growing gaps and every attempt is recorded with its status. Lead time is between 10 seconds and 30 days, and at most 200 pending wakeups per target URL. The target must be a public https address: private, loopback and link-local addresses are refused, so this cannot be pointed at an internal network.

POST https://agent.halowerk.com/v1/wakeup

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
actionstringJaWhat to do.
target_urlstringNeinPublic https URL that receives the POST. Required for schedule and list.
due_atstringNeinAbsolute time as ISO 8601, e.g. 2026-08-12T09:00:00Z. Either this or delay_seconds.
delay_secondsintegerNeinRelative lead time in seconds. Either this or due_at.
payloadSiehe SchemaNeinJSON body delivered with the callback. Up to 16 KB.
header_namestringNeinOptional header name sent with the callback, e.g. X-Agent-Token.
header_valuestringNeinValue for that header. Stored as given.
wakeup_idstringNeinRequired for status and cancel.
notestringNeinFree label carried through.
limitintegerNeinMaximum entries returned by list.
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "required": [
    "action"
  ],
  "additionalProperties": false,
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "schedule",
        "status",
        "cancel",
        "list"
      ],
      "description": "What to do."
    },
    "target_url": {
      "type": "string",
      "maxLength": 2000,
      "description": "Public https URL that receives the POST. Required for schedule and list."
    },
    "due_at": {
      "type": "string",
      "description": "Absolute time as ISO 8601, e.g. 2026-08-12T09:00:00Z. Either this or delay_seconds."
    },
    "delay_seconds": {
      "type": "integer",
      "minimum": 10,
      "maximum": 2592000,
      "description": "Relative lead time in seconds. Either this or due_at."
    },
    "payload": {
      "description": "JSON body delivered with the callback. Up to 16 KB."
    },
    "header_name": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional header name sent with the callback, e.g. X-Agent-Token."
    },
    "header_value": {
      "type": "string",
      "maxLength": 512,
      "description": "Value for that header. Stored as given."
    },
    "wakeup_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "description": "Required for status and cancel."
    },
    "note": {
      "type": "string",
      "maxLength": 200,
      "description": "Free label carried through."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Maximum entries returned by list."
    }
  }
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "action": "schedule",
  "limit": 25
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-01, 15:19 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →