List workflows

GET

/api/v1/workflows

curl -X GET 'https://dashboard.justcrawl.io/api/v1/workflows?status=published' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Returns the latest version per logical workflow in the current org. Each item is enriched with costPerThousand (derived from the org’s vendor-cost table) and a smart block when the workflow has a smart-workflow config attached. When ?domain= is set without an explicit ?status=, the gateway defaults status=published so the response matches what resolveWorkflowForUrl actually picks at dispatch time — drafts inherited from version bumps are not the running workflow and would mislead UI consumers.

Authorizations

• bearerAuth

Parameters

Query Parameters

status

string

Allowed values: draft published

Filter workflows by status.

domain

string

Narrow to workflows routed to this domain (route=“domain:X” or default ”*”); domain-specific routes sorted first.

Responses

200

An array of workflows (latest version each), enriched with cost + smart-workflow config.

Media type application/json

Array<object>

object

workflowId

string format: uuid

name

string

status

string

Allowed values: draft published

version

integer

route

string

nullable

dag

object

nodes

required

Array<object>

object

id

required

string

type

required

string

Allowed values: entry service split result failed

config

object

edges

required

Array<object>

object

id

required

string

from

required

string

to

required

string

type

required

string

Allowed values: default success fail split

costPerThousand

number

nullable

smart

object

strategy

string

Allowed values: success cost reliability

mode

string

Allowed values: auto suggest

domain

string

nullable

hasPendingSuggestion

boolean

createdAt

string format: date-time

Example

[
  {
    "status": "draft",
    "dag": {
      "nodes": [
        {
          "type": "entry"
        }
      ],
      "edges": [
        {
          "type": "default"
        }
      ]
    },
    "smart": {
      "strategy": "success",
      "mode": "auto"
    }
  }
]

400

Validation failed — request body or query is missing/invalid

Media type application/json

object

error

string

Example

{
  "error": "Missing or invalid \"url\" field"
}

401

Missing or invalid authentication token

Media type application/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media type application/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

500

Unexpected server error. Logs and PostHog $exception capture

Media type application/json

object

error

string

Example

{
  "error": "Something went wrong"
}