Workflows

List Workflows

Discover workflows your API key can access, with schemas in legacy mode or paginated marketplace catalog.

curl -X GET 'https://api.edgaze.ai/v1/workflows?offset=0&limit=24&sort=popular' \
  -H 'Authorization: Bearer edgaze_sk_live_YOUR_KEY'

GEThttps://api.edgaze.ai/v1/workflows

Overview#

Use this endpoint to discover which workflows your API key can access before starting a run. It is the first call in most integrations: list or search workflows, read each `inputSchema`, then POST /runs with the workflow id and inputs.

Two discovery modes exist. With no query parameters you get a legacy list of owned and purchased workflows, each with a full `inputSchema` and an `exampleRequest` you can copy. With `scope=marketplace` you get a paginated catalog of public listings with pricing, access state, and `apiRunnableNow` flags.

Call without query params during development to inspect schemas for workflows you already own or bought. Use scope=marketplace with q, offset, and limit when building a marketplace browser or automated runner that searches public per-run listings.

Authorization#

Required scopes (either satisfies this endpoint):

run:readrun:execute

Pass the key as a Bearer token: `Authorization: Bearer edgaze_sk_live_…`

Parameters#

Headers

Authorizationstringheaderrequired

Bearer token with your secret API key.

Example: Bearer edgaze_sk_live_…

Query parameters

scopestringquery

Set to marketplace for paginated public catalog. Omit for legacy owned + purchased list.

Allowed: mine · marketplace

qstringquery

Search title, description, tags, owner handle, or Edgaze Code.

offsetintegerquery

Pagination offset. Used with marketplace scope.

limitintegerquery

Page size (max 50).

sortstringquery

Marketplace sort order.

Allowed: popular · newest

runModelstringquery

Filter by pricing model.

Allowed: free · per_run · legacy_unlock

runnableOnlybooleanquery

When true, only workflows the key holder can run right now.

Response#

All responses are JSON. Errors use `{ error: { code, message } }`. Example success and error payloads are in the request/response panel above.

Edge cases#

Legacy vs marketplace mode

Calling GET /workflows with no query params returns owned + purchased workflows with inputSchema. Adding scope=marketplace switches to paginated catalog metadata without full schemas.

Legacy unlock listings

Workflows with runModel legacy_unlock appear in discovery but apiRunnableNow is false until the buyer completes a one-time unlock purchase.

Scope requirement

Either run:read or run:execute satisfies the scope check for this endpoint.