BLblink
Queue

Create or update a cron schedule

Create or upsert a named cron schedule. If a schedule with the same name already exists, it is atomically replaced. Billed at 0.001 credits per create or update. Pro+ required (50 schedules max on Pro, 200 on Max, unlimited on Team).

post/api/queue/{project_id}/schedule

Request

  • Base URL
    https://core.blink.new
  • URL
    https://core.blink.new/api/queue/{project_id}/schedule
  • Auth
    HTTP bearer

Path parameters

project_idstring required
Example:my-project-123

Unique identifier for the project

Request body

namestring required

Schedule name — also used as the task name delivered to your handler. Must be unique per project.

cronstring required

Standard 5-field cron expression

payloadobject

Arbitrary JSON passed to the handler on each tick

Example request

{
  "name": "daily-digest",
  "cron": "0 9 * * *",
  "payload": {
    "reportType": "daily"
  },
  "options": {
    "timezone": "America/New_York"
  }
}

Response

Schedule created

scheduleIdstring
namestring
cronstring
timezonestring

Example response

{
  "scheduleId": "sch_01jx3k2f9h7q",
  "name": "daily-digest",
  "cron": "0 9 * * *",
  "timezone": "America/New_York"
}

Changes

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