Weighted time-box split API

Allocates a fixed time budget across items proportional to weights, honoring per-item minimums and rounding to a step with largest-remainder so parts sum exactly. Answers 'How do I split my day across tasks by priority weight?', 'How many minutes does each item get?'.

Price$0.02per request

MethodPOST

Route/v1/scheduling/timebox-allocate

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

schedulingtime-blockingtimeboxallocationweightedlargest-remainderbudgetagents

API URLhttps://x402.hexl.dev/v1/scheduling/timebox-allocate

Integration docs

Example request

{
  "totalMinutes": 120,
  "items": [
    {
      "id": "a",
      "weight": 3
    },
    {
      "id": "b",
      "weight": 1
    }
  ],
  "roundToMinutes": 5
}

Example response

{
  "totalMinutes": 120,
  "allocatedMinutes": 120,
  "allocation": [
    {
      "id": "a",
      "minutes": 90,
      "share": 0.75
    },
    {
      "id": "b",
      "minutes": 30,
      "share": 0.25
    }
  ],
  "interpretation": "Split 120 min across 2 items by weight (largest-remainder, step 5)."
}

Input schema

{
  "type": "object",
  "required": [
    "totalMinutes",
    "items"
  ],
  "properties": {
    "totalMinutes": {
      "type": "number",
      "examples": [
        120
      ]
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "roundToMinutes": {
      "type": "number",
      "examples": [
        5
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}