Skip to main content
GET
/
v4
/
workflows
Get a list of workflows
curl --request GET \
  --url https://api.kadoa.com/v4/workflows \
  --header 'x-api-key: <api-key>'
{
  "workflows": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "state": "ACTIVE",
      "displayState": "ACTIVE",
      "userId": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "tags": [
        "<string>"
      ],
      "limit": 123,
      "finishedAt": "2023-11-07T05:31:56Z",
      "startedAt": "2023-11-07T05:31:56Z",
      "jobId": "<string>",
      "dataKey": "<string>",
      "location": {
        "type": "auto",
        "isoCode": "DE"
      },
      "runCosts": 123,
      "runState": "<string>",
      "totalRecords": 123,
      "url": "<string>",
      "urls": [
        "<string>"
      ],
      "browserActions": [
        {
          "type": "<string>",
          "selector": "<string>",
          "text": "<string>",
          "timeMs": 123,
          "url": "<string>"
        }
      ],
      "schema": [
        {
          "name": "<string>",
          "description": "<string>",
          "example": "<string>",
          "dataType": "STRING",
          "isKey": true,
          "isRequired": true,
          "isUnique": true
        }
      ],
      "templateName": "<string>",
      "templateId": "<string>",
      "errors": [
        {
          "errorCode": "<string>",
          "message": "<string>",
          "timestamp": "2023-11-07T05:31:56Z",
          "screenshot": "<string>",
          "context": {
            "url": "<string>",
            "httpStatus": 123,
            "retryCount": 123,
            "details": "<string>",
            "timestamp": "2023-11-07T05:31:56Z"
          }
        }
      ],
      "dataValidation": {
        "enabled": true
      },
      "validationStatistics": {
        "total": {
          "count": 123,
          "change": 123
        },
        "byRule": {
          "ruleName": "<string>",
          "count": 123
        }
      },
      "monitoring": true,
      "notificationConfig": {
        "enabled": true,
        "fields": [
          {
            "fieldName": "<string>",
            "operator": "changed"
          }
        ]
      }
    }
  ],
  "pagination": {
    "totalCount": 123,
    "page": 123,
    "totalPages": 123,
    "limit": 123
  }
}

Authorizations

​
x-api-key
string
header
required

API key for authentication

Query Parameters

​
search
string

Search term to filter workflows by name, URL, or workflow ID

​
skip
integer
default:0

Number of items to skip

Required range: x >= 0
​
limit
integer
default:25

Maximum number of items to return

Required range: x >= 1
​
state
enum<string>

Filter workflows by state

Available options:
ACTIVE,
ERROR,
PAUSED,
NOT_SUPPORTED
​
tags
string[]

Filter workflows by tags

​
monitoring
enum<string>

Filter workflows by monitoring status

Available options:
true,
false
​
updateInterval
enum<string>

Filter workflows by update interval

Available options:
HOURLY,
DAILY,
WEEKLY,
MONTHLY
​
templateId
string

Filter workflows by template ID (DEPRECATED - templates replaced by schemas)

​
includeDeleted
enum<string>
default:false

Include deleted workflows (for compliance officers)

​
format
enum<string>
default:json

Response format (json or csv for export)

Available options:
json,
csv

Response

Successfully retrieved workflows

​
workflows
object[]

List of workflows

​
pagination
object

Pagination information