FlowMate API Documentation
  1. Flows
FlowMate API Documentation
  • Authentication
    • Login
      POST
  • Flows
    • Retrieve all flows
      GET
    • Find Flow by ID
      GET
    • Deletes a flow
      DELETE
    • Update an existing flow
      PATCH
    • Bulk update a number of existing flows
      PATCH
    • Start a flow
      POST
    • Stop a flow
      POST
    • Start multiple flows
      POST
    • Stop multiple flows
      POST
  • User
    • get all users
      GET
    • Create user
      POST
    • get a user by id
      GET
    • get current user
      GET
  • Templates
    • Retrieve all flow templates
      GET
    • Add a new template to the repository
      POST
    • Find Flow Template by ID
      GET
    • Deletes a flow template
      DELETE
    • Update an existing flow template
      PATCH
    • Generate a flow from the flow template
      POST
  • Executions
    • Get Executions
      GET
  • Webhooks
    • Incoming Webhook
      POST
  1. Flows

Find Flow by ID

GET
https://api.platform.openintegrationhub.com/flows/{id}
flows
Returns a single Flow by its ID, if the user is authorized to see it. This requires the 'flows.read' permission

Request

Path Params
id
string <string>
required
ID of flow to return

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.platform.openintegrationhub.com/flows/'

Responses

🟢200OK
application/json
Returns the flow
Body
data
object (Flow) 
optional
name
string 
required
Example:
SnazzyToCodeComponent
description
string 
optional
Example:
This flow polls for persons and posts them on webhoo.site.
tenant
string 
optional
graph
object 
FlowGraph
required
type
enum<string> 
required
Flow type
Allowed values:
ordinaryrealtime
Example:
ordinary
cron
string 
optional
A cron string describing the interval at which this flow is run. If unset, the flow uses webhooks instead
Example:
* /2 * * * *
owners
array[object (Owner) {2}] 
optional
id
string 
required
status
enum<string> 
optional
Flow status, set automatically in response to start/stop commands
Allowed values:
activeinactivestartingstopping
Example:
inactive
createdAt
string <date-time>
required
Timestamp of flow creation
Example:
2019-07-30T12:52:45.957Z
updatedAt
string <date-time>
required
Timestamp of most recent flow update
Example:
2019-07-30T12:52:45.957Z
meta
object 
optional
Example
{
    "data": {
        "name": "SnazzyToCodeComponent",
        "description": "This flow polls for persons and posts them on webhoo.site.",
        "tenant": "string",
        "graph": {
            "nodes": [
                [
                    {
                        "id": "step_1",
                        "componentId": "string",
                        "name": "snazzy adapter for oih",
                        "function": "getPersonsPolling",
                        "description": "New description in progress"
                    },
                    {
                        "id": "step_2",
                        "componentId": "string",
                        "name": "code_component",
                        "function": "execute",
                        "description": "",
                        "fields": {
                            "code": "function* run() {console.log('Calling external URL');yield request.post({uri: 'http://webhook.site/debc8244-3ca0-4449-af2b-e346c4f57b85', body: msg.body, json: true});}"
                        }
                    }
                ]
            ],
            "edges": [
                {
                    "id": "string",
                    "config": {
                        "condition": "string",
                        "mapper": {}
                    },
                    "source": "step_1",
                    "target": "step_2"
                }
            ]
        },
        "type": "ordinary",
        "cron": "* /2 * * * *",
        "owners": [
            {
                "id": "string",
                "type": "string"
            }
        ],
        "id": "string",
        "status": "active",
        "createdAt": "2019-07-30T12:52:45.957Z",
        "updatedAt": "2019-07-30T12:52:45.957Z"
    },
    "meta": {}
}
🟠404Record Not Found
Modified at 2025-01-16 10:16:05
Previous
Retrieve all flows
Next
Deletes a flow
Built with