Skip to main content
GET
/
workflows
List Workflows
curl --request GET \
  --url https://app.splox.io/api/v1/workflows \
  --header 'Authorization: Bearer <token>'
{
  "workflows": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "latest_version": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "version_number": 123,
        "name": "<string>",
        "status": "draft",
        "description": "<string>",
        "metadata": {},
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z"
      },
      "is_public": true
    }
  ],
  "pagination": {
    "limit": 123,
    "next_cursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}
Lists all workflows owned by the authenticated user. Supports cursor-based pagination and search.

​
Usage

curl https://app.splox.io/api/v1/workflows?limit=10 \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger20Items per page (1–100)
cursorstring (uuid)—Cursor from pagination.next_cursor of previous response
searchstring—Filter by workflow name or description

​
Response

{
  "workflows": [
    {
      "id": "019c3221-29d7-70e1-aa1e-dee02589289b",
      "user_id": "0199d001-c45d-9e0f-3456-789012cdef01",
      "latest_version": {
        "id": "019c3221-29da-7d08-93fa-c48dbaa8b1db",
        "workflow_id": "019c3221-29d7-70e1-aa1e-dee02589289b",
        "version_number": 1,
        "name": "My Workflow",
        "description": "A workflow for processing orders",
        "status": "draft",
        "created_at": "2025-10-22T10:00:00Z",
        "updated_at": "2025-10-22T10:00:00Z"
      },
      "created_at": "2025-10-22T10:00:00Z",
      "updated_at": "2025-10-22T10:00:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "next_cursor": "019c3221-29d7-70e1-aa1e-dee02589289b"
  }
}

​
Pagination

If next_cursor is present, pass it as the cursor query parameter to fetch the next page: 
curl "https://app.splox.io/api/v1/workflows?limit=10&cursor=019c3221-29d7-70e1-aa1e-dee02589289b" \
  -H "Authorization: Bearer YOUR_TOKEN"
When next_cursor is null, there are no more results.

​
Notes

Authentication required: Only workflows owned by the authenticated user are returned.

Authorizations

​
Authorization
string
header
required

API token generated from your Splox account settings. Create tokens at https://app.splox.io/account?tab=settings

Query Parameters

​
limit
integer
default:20

Items per page (default: 20, max: 100)

Required range: 1 <= x <= 100
​
cursor
string<uuid>

Cursor for pagination (UUID of last item from previous page)

​
search
string

Filter by workflow name or description

Response

200 - application/json

Workflows retrieved successfully

​
workflows
object[]
​
pagination
object

Cursor-based pagination info