Set up cURL Version Tags with Coralogix.
You can add version tags per application and subsystem using cURL:
URL: Please use the corresponding API endpoint for your domain.
Domain | Version Tags endpoint |
.com | https://webapi.coralogix.com/api/v1/external/tags/ |
.us | https://webapi.coralogix.us/api/v1/external/tags/ |
.in | https://webapi.app.coralogix.in/api/v1/external/tags/ |
.app.coralogixsg.com | https://webapi.coralogixsg.com/api/v1/external/tags/ |
eu2.coralogix.com | https://webapi.eu2.coralogix.com/api/v1/external/tags/ |
cx498.coralogix.com | https://webapi.cx498.coralogix.com/api/v1/external/tags/ |
Method: POST
Body Schema:
{"iconUrl": string,"name": string,"timestamp": date type (JavaScript date string or epoch milliseconds)"application": string[]"subsystem": string[]}
Application: Your Application name.
Subsystem: Your Subsystem(s) name(s). You can input more than one subsystem name, use comma delimiter ‘,’ between Subsystem names.
Name: Your Version Tag name.
Timestamp: Tag Timestamp. (This is OPTIONAL: If a timestamp is not supplied, the current timestamp will be applied).
IconUrl: Tag’s Picture. (This is OPTIONAL: Use an URL (URL encoded) to a valid image file uploaded to a public repository)
Supported Image Formats: png, jpeg, SVG.
Maximum File Size: 50 Kilobytes.
Note: If the URL to the image contains spaces, please use %20.
For example:
https://www.myimagesite.com/Path%20To%20The%20Image.png.
Example (GET):
curl --location --request GET 'http://webapi.coralogix.com/api/v1/external/tags/add?key=&application=Application_Name,Application_Name2&subsystem=Subsystem1,Subsystem2,Subsystem3&name=MyFirstTag×tamp=2020-06-23:09:00:00&iconUrl=your_icon_url'
Example (POST):
curl --location --request POST 'https://webapi.coralogix.com/api/v1/external/tags' \ --header 'Authorization: Bearer 12345678-abcd-efgh-ijk-123456789012' \ --header 'Content-Type: application/json' \ --data-raw '{ "timestamp": 1617793927675, "name": "test tag", "application": ["prd", "dev"], "subsystem": ["app", "mobile"], "iconUrl": "my-avatar.png" }'
Note: application and subsystem should always be contained between square brackets, even if it is an array of one element, for example:"application": ["prd"]
,"subsystem": ["app"]
The API key should be taken from:
Data Flow –> API Keys –> “Alerts, Rules and Tags API Key”
Need help?
Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.
Feel free to reach out to us via our in-app chat or by sending us an email to [email protected].