Skip to content
HALOWERK

Datenwerk

booking page

Creates a SQLite-backed page from caller-supplied absolute ISO slots or relative start delays resolved at creation. Offers are immutable, displayed in the requested IANA time zone with UTC offsets, and identified by an availability SHA-256. One holder of the private fragment link selects a slot and explicitly confirms the reservation. A transaction permits exactly one booking per page; a client nonce makes retries idempotent. POST booking_id and status_token to the returned status_url for.

POST https://daten.halowerk.com/v1/booking-page

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
titlestringYesPlain-text page title; never interpreted as HTML.
summarystringYesPlain-text instructions. Do not include contact details or secrets.
time_zonestringNoIANA display time zone. Underlying slot instants are always returned in UTC.
slotsarrayYesOffered absolute or relative time intervals; duplicate start/end pairs are rejected.
expires_in_secondsintegerNoTime during which this page can accept its single booking; default one day.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "title",
    "summary",
    "slots"
  ],
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "description": "Plain-text page title; never interpreted as HTML."
    },
    "summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Plain-text instructions. Do not include contact details or secrets."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "default": "UTC",
      "description": "IANA display time zone. Underlying slot instants are always returned in UTC."
    },
    "slots": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "oneOf": [
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "start",
              "end"
            ],
            "properties": {
              "start": {
                "type": "string",
                "maxLength": 40,
                "description": "Future whole-minute ISO start with explicit UTC offset, e.g. 2027-01-12T10:00:00Z."
              },
              "end": {
                "type": "string",
                "maxLength": 40,
                "description": "Whole-minute ISO end with explicit UTC offset, after start and at most eight hours later."
              }
            }
          },
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "starts_in_minutes",
              "duration_minutes"
            ],
            "properties": {
              "starts_in_minutes": {
                "type": "integer",
                "minimum": 1,
                "maximum": 525600,
                "description": "Start delay in minutes, rounded up to the next whole UTC minute at page creation. Exact UTC times are returned by the status endpoint."
              },
              "duration_minutes": {
                "type": "integer",
                "minimum": 1,
                "maximum": 480,
                "description": "Duration in whole minutes."
              }
            }
          }
        ]
      },
      "description": "Offered absolute or relative time intervals; duplicate start/end pairs are rejected."
    },
    "expires_in_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 604800,
      "default": 86400,
      "description": "Time during which this page can accept its single booking; default one day."
    }
  }
}

Open original schema

Published input example

{
  "title": "Choose one project meeting",
  "summary": "Choose one proposed time. This private page accepts exactly one booking; share the resulting reference with your agent.",
  "time_zone": "Europe/Berlin",
  "slots": [
    {
      "starts_in_minutes": 1440,
      "duration_minutes": 30
    },
    {
      "starts_in_minutes": 2880,
      "duration_minutes": 30
    }
  ]
}

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