Ideal-day schedule API

Lays out an ideal-day schedule, ordering tasks by priority and placing them back-to-back from a start time with breaks after a continuous-work threshold, reporting what fit and what spilled. Answers 'How should I order my day by priority?', 'Which tasks won't fit today?'.

Price$0.03per request

MethodPOST

Route/v1/scheduling/ideal-day

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

schedulingtime-blockingideal-daypriorityplanningbreakstasksagents

API URLhttps://x402.hexl.dev/v1/scheduling/ideal-day

Integration docs

Example request

{
  "dayStart": "2026-06-04T09:00:00Z",
  "tasks": [
    {
      "id": "deep",
      "durationMinutes": 90,
      "priority": 3
    },
    {
      "id": "email",
      "durationMinutes": 30,
      "priority": 1
    },
    {
      "id": "review",
      "durationMinutes": 60,
      "priority": 2
    }
  ],
  "breakAfterMinutes": 90,
  "breakMinutes": 15,
  "dayMinutes": 240
}

Example response

{
  "scheduledCount": 3,
  "spilledCount": 0,
  "spilled": [],
  "dayEnd": "2026-06-04T13:00:00.000Z",
  "finishesAt": "2026-06-04T12:30:00.000Z",
  "schedule": [
    {
      "type": "task",
      "id": "deep",
      "start": "2026-06-04T09:00:00.000Z",
      "end": "2026-06-04T10:30:00.000Z",
      "minutes": 90
    },
    {
      "type": "break",
      "start": "2026-06-04T10:30:00.000Z",
      "end": "2026-06-04T10:45:00.000Z",
      "minutes": 15
    },
    {
      "type": "task",
      "id": "review",
      "start": "2026-06-04T10:45:00.000Z",
      "end": "2026-06-04T11:45:00.000Z",
      "minutes": 60
    },
    {
      "type": "task",
      "id": "email",
      "start": "2026-06-04T11:45:00.000Z",
      "end": "2026-06-04T12:15:00.000Z",
      "minutes": 30
    },
    {
      "type": "break",
      "start": "2026-06-04T12:15:00.000Z",
      "end": "2026-06-04T12:30:00.000Z",
      "minutes": 15
    }
  ],
  "interpretation": "All 3 tasks fit; day finishes 2026-06-04T12:30:00.000Z."
}

Input schema

{
  "type": "object",
  "required": [
    "dayStart",
    "tasks"
  ],
  "properties": {
    "dayStart": {
      "type": "string",
      "examples": [
        "2026-06-04T09:00:00Z"
      ]
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "breakAfterMinutes": {
      "type": "number",
      "examples": [
        90
      ]
    },
    "breakMinutes": {
      "type": "number",
      "examples": [
        15
      ]
    },
    "dayMinutes": {
      "type": "number",
      "examples": [
        240
      ]
    }
  }
}

Output schema

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