Skip to main content
POST /api/v1/forward/schedules/{schedule_id}/run Creates a Schedule Run immediately without changing the Schedule’s trigger policy. The endpoint returns when the Run record is created, not when execution finishes.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>
Content-TypeNoapplication/json if a body is sent.
Idempotency-KeyNoOptional idempotency key for unsafe requests.

​
Path parameters

ParameterTypeRequiredDescription
schedule_idstringYesForward Schedule ID.

​
Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/schedules/sched_019f00112233445566778899aabbccdd/run' \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "id": "srun_019f00112233445566778899aabbccdd",
  "schedule_id": "sched_019f00112233445566778899aabbccdd",
  "identity_id": "idn_019eabc123",
  "template_id": "tmpl_support",
  "session_id": null,
  "status": "pending",
  "trigger_context": {
    "type": "manual"
  },
  "error": null,
  "result_payload": null,
  "push_sink": null,
  "push_status": "skipped",
  "attempt": 1,
  "triggered_at": "2026-06-22T12:00:00Z",
  "started_at": null,
  "completed_at": null,
  "duration_ms": null,
  "created_at": "2026-06-22T12:00:00Z"
}

​
Response fields

Returns the created Schedule Run object.

​
Errors

HTTPTypeCodeTrigger
401authentication_errorauthentication_requiredPAT invalid or expired.
404not_found_errorschedule_not_foundSchedule does not exist.
409invalid_request_errorschedule_archivedSchedule is archived.
409invalid_request_errorschedule_not_activeSchedule is paused.

​
Notes

  • If the Schedule has reached execution.max_concurrent_runs, Forward still creates a Run with status=skipped and error.type=concurrency_limit_reached.
  • Poll Get Schedule Run until status is completed, failed, or skipped.

Get schedule run

List schedule runs