Introducing: API-parameterized executions

August 8, 2018 | Last updated: September 21, 2020

Introducing: API-parameterized executions

When we develop new features, we try to keep things simple, yet with no compromise to flexibility. A couple weeks ago we delivered parameterized builds. Although it was met with very positive feedback from the community, some users missed the option to parameterize executions via the API as well.

This option has just been delivered: from now on, you can run a pipeline via the API and pass the parameters that will be available in all actions.

Executions can be parameterized in 2 ways:

API Parameterization: Method #1

This way involves the run execution method. In the execution object you need to pass a list of variables in the following way:

"variables": [
         "key": "version",
         "value": "1.0"
         "key": "pass",
         "value": "qwerty",
        "encrypted": true
If you want to hide a value in the logs, add the field "encrypted": true to the variable object.

Running the execution via curl looks like this:

curl --header "Content-Type: application/json" \
--header "Authorization: Bearer $token" \
--data '{ "to_revision": { "revision": "HEAD" }, "comment": "hotfix", "variables": [{ "key": "notify_team", "value": "false" }]}' \$$$$$
To the $token variable you need to assign your Personal account token which you can get here

API Parameterization: Method #2

This way involves the Pass parameters action. First, add this action as described here. Once the execution is waiting for arguments, you can resume it using the apply method:

curl --header "Content-Type: application/json" \
--header "Authorization: Bearer $token" \
--data '{ "operation": "APPLY_VARIABLES", "variables": [{ "key": "notify_team", "value": "false" }]}' \$$$$$

Using parameters

All parameters sent to the execution are available as environment variables in our actions and can be used for various tasks. For example, to determine whether an action should be run or not. In such case, you can use a trigger condition that depends on variable value.

Trigger conditionTrigger condition


Alexander Kus

Alexander Kus

Customer Success Manager

A story-teller and conversation-lover, Alexander decided to invest his skills to help his friends at Buddy transform the cold language of patch notes into exciting narratives. Also: an avid gamer, hip-hop DJ, Liverpool FC fan, absentminded husband, and the father of two.