EdgazeDocsEdgaze Docs
DocumentationAPI Reference
Home
Getting started
API ReferenceAuthenticationQuickstart
Workflows
GETList WorkflowsGETGet WorkflowGETList Workflow VersionsPOSTAccept Workflow Update
Runs
POSTCreate RunGETList RunsGETGet RunPOSTCancel RunGETList Run Events
Guides
WebhooksErrors & Edge CasesBilling & Spend CapsStreaming & Real-timeOpenAPI specification

Platform status

Checking platform status
All documentation
API Reference

REST endpoints, authentication, and webhooks for running workflows from your backend.

Overview
Getting started
API ReferenceAuthenticationQuickstart
Workflows
GETList WorkflowsGETGet WorkflowGETList Workflow VersionsPOSTAccept Workflow Update
Runs
POSTCreate RunGETList RunsGETGet RunPOSTCancel RunGETList Run Events
Guides
WebhooksErrors & Edge CasesBilling & Spend CapsStreaming & Real-timeOpenAPI specification
Developer console

Platform status

Checking platform status
Workflows

Accept Workflow Update

Re-pin a buyer purchase to the workflow's current active immutable version.

curl --fail-with-body --silent --show-error -X POST 'https://api.edgaze.ai/v1/workflows/550e8400-e29b-41d4-a716-446655440000/accept-update' \
  -H "Authorization: Bearer $EDGAZE_API_KEY"
Audience

Developers building with the Edgaze API.

POSThttps://api.edgaze.ai/v1/workflows/{workflow_id}/accept-update

Overview#

This endpoint opts a buyer into the creator's current active version. It changes the immutable version selected by later runs that omit version.

Review release notes and the current input schema before accepting. A new version may change required inputs, output fields, pricing, or provider requirements.

Authorization#

Requires workflow:write. New keys do not receive this scope by default.

workflow:write

Parameters#

Headers

Authorizationstringheaderrequired

Bearer token with the opt-in workflow:write scope.

Example: Bearer edgaze_sk_live_…

Path parameters

workflow_idstringpathrequired

UUID of the purchased workflow.

Example: 550e8400-e29b-41d4-a716-446655440000

Response#

The response returns the new pinnedVersionId. Repeating the call when the purchase already points to the active version is safe and returns 200.

Edge cases#

Owner keys

Owners do not have a buyer purchase row to re-pin and receive 403 forbidden.

Input and output drift

After accepting, refresh GET /workflows/{id}; the active version may define different inputs or outputs.

Related endpoints#

  • List Workflow Versions
  • Get Workflow
  • Create Run
← List Workflow VersionsCreate Run →
On this page
OverviewAuthorizationParametersResponseEdge casesRelated endpoints
© 2026 Edge Platforms, Inc. All rights reserved.