Learn more about Streama© – the foundational technology behind our stateful streaming data platform. Learn More

Version Tags with cURL

You can add version tags per Application and Subsystem using cURL:

URL: https://webapi.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 names. You can input more than one subsystem name, use comma delimiter ‘,’  between subsystems names.
Name: your version tag name.
Timestamp: tag timestamp, if a timestamp is not supplied, the current timestamp will be applied.
IconUrl: tag picture (optional): Use a URL (URL encoded) to a valid image file that you have uploaded to a public repository (png, jpeg, SVG). Max size 50KB.
Note – when applying spaces in the URL use: %20 instead.
Example (GET):
curl --location --request GET 'http://webapi.coralogix.com/api/v1/external/tags/add?key=<YOUR_Alerts & Rules & Tags API Key>&application=Application_Name,Application_Name2&subsystem=Subsystem1,Subsystem2,Subsystem3&name=MyFirstTag&timestamp=2020-06-23:09:00:00&iconUrl=your_icon_url' \
--data-raw ''
Example (POST):
curl --location --request POST 'https://webapi.coralogix.com/api/v1/external/tags' \
--header 'Authorization: Bearer <YOUR_Alerts & Rules & Tags API Key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "timestamp": 1617793927675,
    "name": "test tag",
    "application": ["prd", "dev"],
    "subsystem": ["app", "mobile"],
    "iconUrl": "my-avatar.png"
}'

The API key should be taken from your team settings –> Account –> API Access –>Alerts & Rules & Tags API Key