List Workflow Versions
List immutable workflow versions visible to the caller and inspect active and purchase pins.
curl --fail-with-body --silent --show-error 'https://api.edgaze.ai/v1/workflows/550e8400-e29b-41d4-a716-446655440000/versions' \ -H "Authorization: Bearer $EDGAZE_API_KEY"
Developers building with the Edgaze API.
https://api.edgaze.ai/v1/workflows/{workflow_id}/versionsOverview#
Use this endpoint to compare the creator's active version with the version attached to a buyer's purchase. Owners see the complete history. Buyers see the versions their entitlement allows them to evaluate.
Do not assume that one workflow id always resolves to one graph. A fixed pinnedVersionId continues to run until the buyer accepts an update. A null pin follows activeVersionId.
Authorization#
Requires either run:read or run:execute.
run:readrun:executeParameters#
Headers
AuthorizationstringheaderrequiredBearer token with run:read or run:execute scope.
Example: Bearer edgaze_sk_live_…
Path parameters
workflow_idstringpathrequiredUUID of the workflow.
Example: 550e8400-e29b-41d4-a716-446655440000
Response#
updateAvailable is true only when a buyer has a non-null purchase pin that differs from the active version. Review releaseNotes and refresh the workflow's input schema before changing versions.
Edge cases#
A null pinnedVersionId follows the active version. updateAvailable is false because there is no fixed purchase pin to compare.
Either run:read or run:execute authorizes this read operation.