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>"
}
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"
}