Skip to content
HALOWERK

File Formats and Conversion

calendar todo reminder instants

Calendar task reminders resolve offsets before each UTC deadline and return the notifications in time order. Use it when an agent needs a task reminder schedule.

POST https://format.halowerk.com/v1/calendar-todo-reminder-instants

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
tasksarrayYes
Show full input schema
{
  "type": "object",
  "properties": {
    "tasks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "uid": {
            "type": "string",
            "maxLength": 100,
            "minLength": 1
          },
          "due": {
            "type": "string",
            "maxLength": 30,
            "minLength": 1
          },
          "lead_minutes": {
            "type": "integer",
            "minimum": 0,
            "maximum": 525600
          }
        },
        "required": [
          "uid",
          "due",
          "lead_minutes"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 60
    }
  },
  "required": [
    "tasks"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "tasks": [
    {
      "uid": "check",
      "due": "2026-11-19T16:00:00Z",
      "lead_minutes": 30
    },
    {
      "uid": "publish",
      "due": "2026-11-19T16:00:00Z",
      "lead_minutes": 60
    }
  ]
}

Result & documentation

Show published result schema
{
  "type": "object",
  "required": [
    "measured_at",
    "source",
    "data",
    "limitations"
  ],
  "properties": {
    "measured_at": {
      "type": "string"
    },
    "source": {
      "type": "object",
      "required": [
        "reference",
        "retrieved_at"
      ],
      "properties": {
        "reference": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        }
      }
    },
    "data": {
      "type": "object",
      "properties": {
        "reminders": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "uid": {
                "type": "string"
              },
              "at": {
                "type": "string"
              }
            },
            "required": [
              "uid",
              "at"
            ]
          }
        }
      },
      "required": [
        "reminders"
      ]
    },
    "limitations": {
      "type": "string"
    }
  }
}

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-20 UTC.

More endpoints in this hub

All endpoints in this hub โ†’