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 with access to the workflow also see the complete history, with isActive marking the creator's active version and isPurchased marking the version their purchase is pinned to. Callers without access receive 403 forbidden.
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.
Related endpoints#
Was this useful?
Your response helps us improve the documentation.