GET
/
v1
/
{workspace}
/
workflow
/
List Workflows
curl --request GET \
  --url https://api.suprsend.com/v1/{workspace}/workflow/ \
  --header 'Authorization: Bearer <token>'
{
  "meta": {
    "count": 92,
    "limit": 10,
    "offset": 0
  },
  "results": [
    {
      "$schema": "https://schema.suprsend.com/workflow/v1/schema.json",
      "slug": "survey-reminder",
      "is_enabled": true,
      "created_at": "2025-06-27T03:26:48.793551Z",
      "last_executed_at": "2025-06-27T04:48:20.653366Z",
      "name": "Survey Reminder",
      "description": null,
      "updated_at": "2025-06-27T03:36:05.623939Z",
      "commit_message": "Survey completed",
      "hash": "ed3e630c1526170564c962db00dbfcfef997e995f62f67c068a8c9c1d5efbc13",
      "status": "active",
      "category": "transactional",
      "tags": [
        "reminder"
      ],
      "ratelimit": null,
      "conditions": [],
      "trigger_type": "api",
      "trigger_events": [],
      "override_recipients_type": null,
      "override_recipients_user_expr": null,
      "override_recipients_single_object_fields_expr": null,
      "override_actor_user_expr": null,
      "override_tenant_expr": null,
      "active_at": "2025-06-27T03:36:05.623845Z",
      "updated_by": {
        "name": "Nikita",
        "email": "nikita@suprsend.com"
      },
      "tree": {
        "nodes": [
          {
            "name": "Multi-Channel",
            "node_type": "send_multi_channel",
            "properties": {
              "template": "11-performance-review-session",
              "channels": [],
              "channels_expr": null,
              "success": "seen",
              "success_is_event": false
            },
            "description": "",
            "schema_version": "1"
          }
        ]
      },
      "validation_result": {
        "is_valid": true
      }
    }
  ]
}
Retrieve a paginated list of workflows in a given workspace. You can filter workflows by mode (draft/live) and specify particular workflow slugs to retrieve.

Authorizations

​
Authorization
string
header
required

Pass as ServiceToken <Service_Token>. Get Service Token from SuprSend dashboard -> Account Settings -> Service Tokens section.

Path Parameters

​
workspace
string
required

Workspace slug (staging, production, etc.)

Query Parameters

​
mode
enum<string>
default:draft

Mode to filter workflows (draft or live). By default, draft workflows are returned.

Available options:
draft,
live
​
slugs
string

Comma-separated list of workflow slugs to filter. This can be used to filter workflows by slug.

Response

200
application/json

Successfully retrieved list of workflows

The response is of type object.