BLblink
Queue

Enqueue a background task

Dispatch a background task to the project's Blink Backend handler (POST /api/queue). Use options.queue for named FIFO queues with parallelism control. Billed at 0.001 credits per enqueue. Requires Pro+ plan.

post/api/queue/{project_id}/enqueue

Request

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

Path parameters

project_idstring required
Example:my-project-123

Unique identifier for the project

Request body

taskNamestring required

Task identifier matched against your handler's routing logic.

payloadobject

Arbitrary JSON passed to the handler

Example request

{
  "taskName": "send-welcome-email",
  "payload": {
    "to": "user@example.com",
    "name": "Alice"
  },
  "options": {
    "queue": "emails",
    "delay": "5m",
    "retries": 3,
    "timeout": "30s"
  }
}

Response

Task enqueued

taskIdstring
statusstring
messageIdstring nullable

Example response

{
  "taskId": "tsk_aBcDeFgHiJkL",
  "status": "pending",
  "messageId": "msg_01jx3k2f9h7q"
}

Changes

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