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

{
  "_id": "69fdfe21957a1b5597aa04bd",
  "name": "Daily Sync",
  "description": "",
  "published": true,
  "slug": "hubspot",
  "associated_application": "6992cc7dc124a392c80e9e9c",
  "is_v2": true,
  "nodes": [
    { "id": "1", "type": "start" },
    { "id": "2", "type": "action" }
  ],
  "edges": [ { "source": "1", "target": "2" } ],
  "environment": "test"
}
Return a workflow by ID with an allowlisted set of fields, including its nodes (with the start node’s trigger config) and edges. For safety this is org-scoped: it returns 403 if the workflow is private to a different linked account.
This read is org-scoped, so it works for public (org, slug-level) workflows. To read a private workflow (one that belongs to a linked account), pass that account’s linked_account_id.

​
Authentication

​
x-api-key
string
required
Your Refold API key.
​
linked_account_id
string
Required to access a workflow that is private to a linked account.

​
Path Parameters

​
workflow_id
string
required
The workflow ID.

​
Response

​
_id
string
Workflow ID.
​
name
string
Workflow name.
​
published
boolean
Whether it’s published.
​
slug
string
Associated application slug.
​
associated_application
string
Associated application ID.
​
nodes
array
Workflow nodes (the start node carries trigger config).
​
edges
array
Connections between nodes.
{
  "_id": "69fdfe21957a1b5597aa04bd",
  "name": "Daily Sync",
  "description": "",
  "published": true,
  "slug": "hubspot",
  "associated_application": "6992cc7dc124a392c80e9e9c",
  "is_v2": true,
  "nodes": [
    { "id": "1", "type": "start" },
    { "id": "2", "type": "action" }
  ],
  "edges": [ { "source": "1", "target": "2" } ],
  "environment": "test"
}

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