Deploy Update
Deploy an Update using our REST API deploy_update endpoint.
post
https://api.connect.jfrog.io/v2/
deploy_update
Deploy update
Possible types and values:
  • devices_filter object:
    • filters key:
      • Possible values for the type key:
        • specific_device - Set this value if you want to filter one specific device. The value of the value key of this type is the ID of the device you want to filter (you can obtain the id on Connect dashboard). The possible operand key values for this type are: is, is_not
        • tag - Set this value if you want to filter devices by a tag. The value of the value key of this type is the name of the tag you want to filter (you can obtain the tag name on Connect dashboard). The possible operand key values for this type are: is, is_not
        • app - Set this value if you want to filter devices by the apps that are set to them. The value of the value key of this type is the app name. The possible operand key values for this type are: is, is_not.
        • device_state - Set this value if you want to filter devices by their state. The possible values of the value key of this type are: online, offline. The possible operand key value of this type is: is
        • update_status - Set this value if you want to filter devices by their last update status. The possible values of the value key of this type are: pending, in_progress, success, failed, aborted. The possible operand key value of this type is: is, is_not
All values must be of type: String.
Full payload example:
{
"user_token": "<user token>",
"device_filter": {"project": {"name": "Demo"},
"groups": [{"name": "TestGroup1"}, {"name": "TestGroup2"}],
"filters": [{"type": "specific_device",
"operand": "is",
"value": "d-4ec7-1be9"}]},
"deployment_configuration": {
"flow_id": "f-dd0c-73b9",
"comment": "test webhook 1",
"app": {"name": "default_app", "version": "v1.1"},
"parameters_mapping": {
"username": "ubuntu",
"conf_path": "/etc/app/settings.conf"
}
}
}

Code Example

Python
import json
import requests
#Upswift tokens
user_token = "<user token>"
json_content = {'user_token': user_token,
'device_filter': {'project': {'name': 'Demo'},
'groups': [{'name': 'TestGroup1'}, {'name': 'TestGroup2'}],
'filters': [{'type': 'specific_device',
'operand': 'is',
'value': 'd-4ec7-1be9'}]},
"deployment_configuration": {
"flow_id": "f-dd0c-73b9",
'comment': 'test webhook 1',
'app': {'name': 'default_app', 'version': 'v1.1'},
"parameters_mapping": {
"username": "ubuntu",
"conf_path": "/etc/app/settings.conf",
}
}
}
call_request = requests.post("https://api.connect.jfrog.io/v2/deploy_update", json=json_content)
call_response = json.loads(call_request.text)
if call_request.status_code != 200:
if call_request.status_code == 429:
error = "API limit reached"
else:
error = call_response["error_message"]
print(error)
else:
response_message = call_response["message"]
Copy link