Skip to main content
POST
/
jobs
/
{id}
/
trigger
Trigger job
curl --request POST \
  --url https://api.example.com/jobs/{id}/trigger
{
  "id": "<string>",
  "status_code": 123,
  "success": true,
  "response_time_ms": 123,
  "fired_at": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cronapi.dev/llms.txt

Use this file to discover all available pages before exploring further.

Manually triggers the job’s webhook without waiting for the scheduled time. The job’s status is updated to completed or failed based on the webhook response.
Only jobs with status: "pending" can be triggered. Already completed or failed jobs return a 400 error.

​
Path parameters

​
id
string
required
The UUID of the job to trigger.

​
Response

Returns the execution result.
​
status_code
integer
HTTP status code returned by the webhook endpoint.
​
success
boolean
true if the webhook returned a 2xx status code.
​
response_time_ms
integer
Execution time in milliseconds.
​
fired_at
string
ISO 8601 timestamp of when the webhook was fired.
curl -X POST https://app.cronapi.dev/api/v1/jobs/b2c3d4e5-f6a7-8901-bcde-f12345678901/trigger \
  -H "Authorization: Bearer your_api_key_here"
200
{
  "status_code": 200,
  "success": true,
  "response_time_ms": 230,
  "fired_at": "2026-04-15T14:35:00.123Z"
}
400
{
  "error": "Job already completed"
}