Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

POST/v1/cues/{cue_id}/fire

Fire a Cue

Manually fire a cue. Creates an execution immediately regardless of schedule.

cue_idstringrequiredpath

The cue ID to fire.

Manually creates an execution for this cue. Works on active and paused cues. Rate limited to 10 manual fires per hour.

The execution is created with triggered_by: "manual_fire" so you can distinguish manual triggers from scheduled ones in your execution history.

For webhook transport cues, the execution is immediately dispatched for delivery. For worker transport cues, the execution appears in the claimable queue.

Request

bash

curl -X POST https://api.cueapi.ai/v1/cues/cue_abc123/fire \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "cue_id": "cue_abc123",
  "scheduled_for": "2026-03-23T09:00:00Z",
  "status": "pending",
  "triggered_by": "manual_fire"
}

json

{"error": {"code": "cue_not_found", "message": "Cue not found", "status": 404}}

json

{"error": {"code": "rate_limit_exceeded", "message": "Maximum 10 manual fires per hour", "status": 429}}

Previous← Delete a Cue NextList Executions →