Workflows

List Workflows

GET
/v2/workflows
x-api-key<token>

Authenticate using API Key in request header

In: header

Query Parameters

limit?integer
Default50
Range1 <= value <= 100
workflowIDs?array<string>
Items1 <= items
workflowNames?array<string>
Items1 <= items
displayName?string

Used for search over display names of workflows. Will perform case-insensitive substring matching.

sortOrder?string

Specifies sorting behavior. The two options are asc and desc to sort ascending and descending respectively, with default sort being ascending. Paging works in both directions.

Default"asc"
Value in"asc" | "desc"
startingAfter?string

A cursor to use in pagination. startingAfter is a function ID that defines your place in the list.

endingBefore?string

A cursor to use in pagination. endingBefore is a function ID that defines your place in the list.

tags?array<string>

Filter workflows by tags. Workflows must contain all specified tags.

Items1 <= items
functionIDs?array<string>

Filter workflows by function IDs. Returns workflows whose current version uses the current version of the specified functions.

Items1 <= items
functionNames?array<string>

Filter workflows by function names. Returns workflows whose current version uses the current version of the specified functions.

Items1 <= items
functionIDVersionNums?array<string>

Filter workflows by specific function versions using function IDs. Format: functionID.versionNum (e.g., "f_abc123.2"). Returns workflows whose current version uses the specified function versions.

Items1 <= items
functionNameVersionNums?array<string>

Filter workflows by specific function versions using function names. Format: functionName.versionNum (e.g., "invoice-processing.2"). Returns workflows whose current version uses the specified function versions. Resolves to functions that currently have the specified names.

Items1 <= items

Response Body

application/json

curl -X GET "https://api.bem.ai/v2/workflows?tags=billing%2Cfinance&functionIDs=f_123%2Cf_456&functionNames=transform-invoice%2Cextract-data&functionIDVersionNums=f_123.2%2Cf_456.1&functionNameVersionNums=transform-invoice.2%2Cextract-data.1"
{
  "workflows": [
    {
      "id": "string",
      "name": "string",
      "versionNum": 0,
      "displayName": "string",
      "emailAddress": "string",
      "tags": [
        "billing",
        "finance",
        "automated"
      ],
      "mainFunction": {
        "id": "string",
        "name": "string",
        "versionNum": 0
      },
      "relationships": [
        {
          "sourceFunction": {
            "id": "string",
            "name": "string",
            "versionNum": 0
          },
          "destinationName": "string",
          "destinationFunction": {
            "id": "string",
            "name": "string",
            "versionNum": 0
          }
        }
      ],
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "audit": {
        "workflowCreatedBy": {
          "userActionID": "string",
          "userID": "string",
          "userEmail": "string",
          "apiKeyName": "string",
          "emailAddress": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        },
        "workflowLastUpdatedBy": {
          "userActionID": "string",
          "userID": "string",
          "userEmail": "string",
          "apiKeyName": "string",
          "emailAddress": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        },
        "versionCreatedBy": {
          "userActionID": "string",
          "userID": "string",
          "userEmail": "string",
          "apiKeyName": "string",
          "emailAddress": "string",
          "createdAt": "2019-08-24T14:15:22Z"
        }
      }
    }
  ],
  "totalCount": 0,
  "error": "string"
}