day-plan

Extract calendar entries from an image, PDF or DOCX file. Returns incomplete-time drafts as unscheduled_entries, timed one-offs as events, and timed recurrences as event_series without expanding recurrences. This endpoint is stateless and never writes records.

post/day-plan/import/file

Request

  • Base URL
    https://api.focusbear.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

keystring required

R2 object key returned by a Day Plan calendar import upload-url endpoint

client_datetime_isostring

Client-local ISO 8601 datetime used to resolve relative calendar entries

repeated_events_end_onstring

ISO calendar date (yyyy-MM-dd). Providing it enables recurrence detection and sets the requested inclusive end date for recurring drafts.

Example request

{
  "client_datetime_iso": "2026-07-20T09:30:00+08:00",
  "repeated_events_end_on": "2026-09-30"
}

Response

truncatedboolean required

True when unique model drafts exceeded the shared 500-draft response limit.

Example response

{
  "unscheduled_entries": [
    {
      "date": "2026-07-16",
      "start_time": "09:00",
      "end_time": "10:00",
      "repeat_end_on": "2026-09-30"
    }
  ],
  "events": [
    {
      "date": "2026-07-16",
      "start_time": "09:00",
      "end_time": "10:00"
    }
  ],
  "event_series": [
    {
      "date": "2026-07-16",
      "start_time": "09:00",
      "end_time": "10:00",
      "repeat_end_on": "2026-09-30"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.