Trigger REST API

[mehmettokgoz]

We currently provide JS/TS and Golang SDKs that exposes the official trigger() method to start a new workflow run. To support a broader range of use cases, we plan to introduce a REST API endpoint that allows workflows to be started via a simple HTTP call. This will enable developers to trigger workflow runs from environments where our official SDK is not available.

A draft version of the API is as follows:

curl -X POST https://qstash.upstash.io/v2/workflows/trigger/<WORKFLOW_URL> \
    -H "Authorization: Bearer <QSTASH_TOKEN>"

It will be possible to pass configuration options (retries, flow-control) as HTTP headers when calling this endpoint.

Currently, the workaround is to call the workflow endpoint directly. However, this approach is not safe. If the workflow endpoint is temporarily unreachable, the request will fail without retries since it bypasses Upstash Workflow's delivery system for trigger request.