GET /api/workflows — List All Workflows

Retrieve every Workflow in your account, including IDs, names, step configurations, run counts, and timestamps. GET /api/workflows returns all Workflows belonging to your account and active Workspace. Use it to inventory your automations or fetch a workflow_id before calling POST /api/workflows/{workflow_id}/run.

Endpoint

GET https://api.valendata.com/api/workflows

Authentication

This endpoint requires a session token, not an API key. Pass your JWT in the Authorization header:

Authorization: Bearer YOUR_SESSION_TOKEN

To get a session token, call POST /api/auth/login with your email and password. The response includes a token field — use that here.

Example Request

curl https://api.valendata.com/api/workflows \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Response

A successful request returns HTTP 200 with a flat JSON array of Workflow objects. There is no pagination envelope — all Workflows are returned in a single response, ordered by created_at descending.

Workflow Object

string

Unique identifier for the Workflow. Plain UUID, for example 3f2a1bc4-.... Pass this as workflow_id when calling POST /api/workflows/{workflow_id}/run.

string

The human-readable name of the Workflow.

string

URL-safe identifier for the Workflow.

string | null

Short description of the Workflow’s purpose, if set.

string

Current status of the Workflow.

string

Either private or public. Public Workflows appear in the Marketplace.

array | null

The Workflow’s step definitions in order. Each step includes its type (agent, code, http, transform, dfuse, skill), name, and configuration.

integer

Total number of times this Workflow has been executed.

string | null

ISO 8601 UTC timestamp of the most recent run, or null if the Workflow has never been run.

string

ISO 8601 UTC timestamp of when the Workflow was created.

string

ISO 8601 UTC timestamp of the most recent update.

string | null

Display name of the Workflow’s owner.

array

List of domains this Workflow interacts with, derived from its step configurations.

Example Response

[
  {
    "id": "3f2a1bc4-e89b-12d3-a456-426614174000",
    "name": "Competitor Pricing Monitor",
    "slug": "competitor-pricing-monitor",
    "description": "Extracts pricing data from a competitor URL daily.",
    "status": "active",
    "visibility": "private",
    "steps": [],
    "total_runs": 42,
    "last_run_at": "2026-08-20T09:15:00Z",
    "created_at": "2026-08-05T10:30:00Z",
    "updated_at": "2026-08-19T14:22:00Z",
    "creator_name": "Joe Adepoju",
    "target_domains": ["competitor.com"]
  }
]

Error Handling

HTTP Status	Meaning
`401`	Unauthorized — session token is missing or expired.
`500`	Internal error on Valendata’s side.

Overview

Skills

Workflows

Runs

GET /api/workflows — List All Workflows

Endpoint

Authentication

Example Request

Response

Workflow Object

Example Response

Error Handling

​Endpoint

​Authentication

​Example Request

​Response

​Workflow Object

​Example Response

​Error Handling

Endpoint

Authentication

Example Request

Response

Workflow Object

Example Response

Error Handling