Skip to main content
GET
/
api
/
v2
/
public
/
workflow
curl -X GET "https://app.refold.ai/api/v2/public/workflow" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"

{
  "docs": [
    {
      "_id": "69fdfe21957a1b5597aa04bd",
      "name": "Daily Sync",
      "published": true,
      "slug": "hubspot"
    }
  ],
  "schema": null,
  "totalDocs": 2,
  "limit": 10,
  "page": 1,
  "totalPages": 1,
  "hasNextPage": false
}
List workflows. There are two kinds, and what you get back depends on scope:
  • Public workflows — org-level, tied to application slugs and available across the org. Returned when no linked account is in scope (and, by default, as the public workflows available to a linked account).
  • Private workflows — belong to a specific linked account. Returned when you pass scope=private together with a linked_account_id.
In other words: a request authenticated as a linked account with scope=private returns that account’s private workflows; otherwise you get public (org/slug-level) workflows.

​
Authentication

This endpoint is scoped to a linked account, so it accepts either authentication method. Option 1 — API key
​
x-api-key
string
Your Refold API key.
​
linked_account_id
string
Include to list a linked account’s public (or, with scope=private, private) workflows. Omit for org-level workflows.
Option 2 — Session token
​
Authorization
string
Session token. Format: Bearer YOUR_SESSION_TOKEN

​
Query Parameters

​
scope
string
Set to private (with a linked account) to list that account’s private workflows.
​
slug
string
Filter by application slug.
​
application_id
string
Filter by application ID.
​
name
string
Filter by name.
​
published
boolean
Filter by published state.
​
start_date
string
ISO start of the date range.
​
end_date
string
ISO end of the date range.
​
page
integer
default:"1"
Page number.
​
limit
integer
default:"10"
Page size.

​
Response

Returns a paginated envelope. Includes a schema describing the workflow list shape.
​
docs
array
Workflows.
​
totalDocs
integer
Total workflows.
​
hasNextPage
boolean
Whether another page follows.
{
  "docs": [
    {
      "_id": "69fdfe21957a1b5597aa04bd",
      "name": "Daily Sync",
      "published": true,
      "slug": "hubspot"
    }
  ],
  "schema": null,
  "totalDocs": 2,
  "limit": 10,
  "page": 1,
  "totalPages": 1,
  "hasNextPage": false
}

curl -X GET "https://app.refold.ai/api/v2/public/workflow" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"