The Workflow API in Cobalt allows users to execute workflows programmatically instead of relying on event-based triggers. This API-based execution provides flexibility in triggering workflows directly through an API call.

​

Setting up Workflow API as Trigger

Let’s first see how you can setup a Workflow API for any of the workflows that you have in Cobalt.

To set up a workflow to be triggered via the Workflow API:

​

Workflow API endpoints

There are two APIs related to workflow execution: the /execute API and the /response API.

​

/execute API

To execute a workflow, make a POST request to the workflow execution endpoint.

If a Workflow Alias has been defined, you can replace workflow_id with the alias in the API. Send the event data in the request body, similar to how you would handle event payloads. If there is no payload, you can pass an empty JSON object .

Request Headers

• linked_account_id: The Linked account for which you want to execute the workflow.

• slug: Slug of the integration in which workflow is present.

• x-api-key: Your Cobalt API key

• sync_execution: By default, this is set to false, which means the API response will only include the execution_id. If you set sync_execution to true, the API response will include both the execution_id and the return_value object containing response as set in the Response node.

Sample cURL for Workflow Execute API:

curl --location --request POST 'https://api.gocobalt.io/api/v1/workflow/{workflow_id or alias}/execute' \
--header 'content-type: application/json' \
--header 'linked_account_id: john@acme.io' \
--header 'slug: asana' \
--header 'x-api-key: tkb5b9f358-4160-4fea-a926-cf52b271489d' \
--header 'sync_execution: false' \
--data '
{
"Task Name":"Sample task",
"Created_at":"2024-2-1",
"Assigned_to":"John Doe"
}'

Response

{
"return_value":
    {
        "success":"true",
        "new_note":"This is the updated note content"
    },
"execution_id":"66e404464f475f36c0c95b5d"
}

​

/response API

To fetch the response received in a previously executed workflow, use the following API.

Request Headers

• linked_account_id: The Linked account for which the workflow was executed.

• x-api-key: Your Cobalt API key

Sample cURL for Execution Response API:

curl --location --request GET 'https://api.gocobalt.io/api/v1/execution/{execution_id}/response' \
--header 'linked_account_id: john@acme.io' \
--header 'x-api-key: tkb5b9f358-4160-4fea-a926-cf52b271489d'

Response

The API response will include the data set in the workflow’s Response node, as well as the status of the workflow, which can be one of the following:

• COMPLETED: The workflow has successfully finished.

• RUNNING: The workflow is still in progress.

• ERRORED: The workflow encountered an error.

{
    "response":  {
        "success":"true",
        "new_note":"This is the updated note content"
    },
    "status": "COMPLETED"
}