List Schedules

List the scheduled triggers for a linked account.

GET /api/v1/workflow/public/scheduled

cURL

curl -X GET "https://app.refold.ai/api/v1/workflow/public/scheduled?limit=10" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"

200

{
  "docs": [
    {
      "_id": "6a312175d0aeb8165bdac34a",
      "event_id": "6a312175d0aeb8165bdac328",
      "workflow": {
        "_id": "6a17f312aae660322b26883e",
        "name": "Daily Contact Sync",
        "associated_application": { "_id": "6992cc7dc124a392c80e9e9c", "name": "Hubspot" }
      },
      "config_id": "user_12345",
      "linked_account_id": "user_12345",
      "trigger_type": "cron",
      "cron_patten": "5 * * * *",
      "trigger_interval": [],
      "status": "running",
      "inactive": false,
      "registered_by_api": false
    }
  ],
  "totalDocs": 3,
  "limit": 10,
  "page": 1,
  "totalPages": 1,
  "hasNextPage": false
}

List the scheduled triggers registered for a linked account, paginated. Each entry includes the workflow it runs, its cron/interval config, and its current status.

Schedules are part of the v1 workflow service (/api/v1/workflow/public/scheduled).

Authentication

x-api-key · string · required

Your Refold API key.

linked_account_id · string · required

The linked account whose schedules to list.

Query Parameters

page · integer · default: "1"

Page number.

limit · integer · default: "10"

Page size.

Response

200 OK

Returns a paginated envelope.

docs · array

Schedules.

Show properties

_id · string

Schedule ID.

event_id · string

The event fired.

workflow · object

The scheduled workflow {_id, name, associated_application}.

config_id · string

The config it runs under.

trigger_type · string

cron or interval.

cron_patten · string

Cron expression (cron schedules).

trigger_interval · array

Interval dates (interval schedules).

status · string

running or paused.

inactive · boolean

true when paused.

registered_by_api · boolean

Whether it was created via the API.

totalDocs · integer

Total schedules.

hasNextPage · boolean

Whether another page follows.

401 Unauthorized

status_code · integer

HTTP status code.

http_error_type · string

Error category.

error · string

Internal error code.

message · string

Human-readable error description.

200

{
  "docs": [
    {
      "_id": "6a312175d0aeb8165bdac34a",
      "event_id": "6a312175d0aeb8165bdac328",
      "workflow": {
        "_id": "6a17f312aae660322b26883e",
        "name": "Daily Contact Sync",
        "associated_application": { "_id": "6992cc7dc124a392c80e9e9c", "name": "Hubspot" }
      },
      "config_id": "user_12345",
      "linked_account_id": "user_12345",
      "trigger_type": "cron",
      "cron_patten": "5 * * * *",
      "trigger_interval": [],
      "status": "running",
      "inactive": false,
      "registered_by_api": false
    }
  ],
  "totalDocs": 3,
  "limit": 10,
  "page": 1,
  "totalPages": 1,
  "hasNextPage": false
}

cURL

curl -X GET "https://app.refold.ai/api/v1/workflow/public/scheduled?limit=10" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"