Skip to content
HALOWERK

Datenwerk

agenda timebox

Items are scheduled in the given order from the start time, with an optional buffer between items and a break inserted after the item that reaches the break interval. If a total length is set and the plan is too long, overflow=compress shortens flexible items towards their minimum, lowest priority first (priority 5 before 1, proportional within a level, whole minutes by largest remainder); fixed items are never shortened. overflow=drop removes the lowest-priority, then latest items until the.

POST https://daten.halowerk.com/v1/agenda-timebox

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
startstringYesStart time of the meeting, HH:MM.
total_minutesintegerNoAvailable meeting length; omit for no limit.
itemsarrayYes
buffer_minutesintegerNo
break_every_minutesintegerNoInsert a break once this much time passed since the last break.
break_minutesintegerNo
overflowstringNo
default_min_sharenumberNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "start",
    "items"
  ],
  "properties": {
    "start": {
      "type": "string",
      "pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
      "description": "Start time of the meeting, HH:MM."
    },
    "total_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 1440,
      "description": "Available meeting length; omit for no limit."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 60,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "title",
          "minutes"
        ],
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "minutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 600,
            "description": "Requested length."
          },
          "min_minutes": {
            "type": "integer",
            "minimum": 1,
            "maximum": 600,
            "description": "Shortest acceptable length (default: minutes x default_min_share)."
          },
          "priority": {
            "type": "integer",
            "minimum": 1,
            "maximum": 5,
            "default": 3,
            "description": "1 = most important, 5 = first to shorten or drop."
          },
          "fixed": {
            "type": "boolean",
            "default": false,
            "description": "Never shorten this item."
          },
          "owner": {
            "type": "string",
            "maxLength": 80
          }
        }
      }
    },
    "buffer_minutes": {
      "type": "integer",
      "minimum": 0,
      "maximum": 30,
      "default": 0
    },
    "break_every_minutes": {
      "type": "integer",
      "minimum": 15,
      "maximum": 480,
      "description": "Insert a break once this much time passed since the last break."
    },
    "break_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 10
    },
    "overflow": {
      "type": "string",
      "enum": [
        "compress",
        "drop",
        "error"
      ],
      "default": "compress"
    },
    "default_min_share": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1,
      "default": 0.5
    }
  }
}

Open original schema

Published input example

{
  "start": "09:00",
  "total_minutes": 60,
  "items": [
    {
      "title": "Status",
      "minutes": 30,
      "priority": 1
    },
    {
      "title": "Roadmap",
      "minutes": 40,
      "priority": 3
    },
    {
      "title": "AOB",
      "minutes": 20,
      "priority": 2
    }
  ]
}

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