curl --request PUT \
--url https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: <content-type>' \
--data '
{
"tags": [
{
"key": "Division",
"value": "payments"
},
{
"key": "Owner",
"value": "platform-team"
}
]
}
'import requests
url = "https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags"
payload = { "tags": [
{
"key": "Division",
"value": "payments"
},
{
"key": "Owner",
"value": "platform-team"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "<content-type>"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': '<content-type>'},
body: JSON.stringify({
tags: [{key: 'Division', value: 'payments'}, {key: 'Owner', value: 'platform-team'}]
})
};
fetch('https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'tags' => [
[
'key' => 'Division',
'value' => 'payments'
],
[
'key' => 'Owner',
'value' => 'platform-team'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags"
payload := strings.NewReader("{\n \"tags\": [\n {\n \"key\": \"Division\",\n \"value\": \"payments\"\n },\n {\n \"key\": \"Owner\",\n \"value\": \"platform-team\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "<content-type>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "<content-type>")
.body("{\n \"tags\": [\n {\n \"key\": \"Division\",\n \"value\": \"payments\"\n },\n {\n \"key\": \"Owner\",\n \"value\": \"platform-team\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = '<content-type>'
request.body = "{\n \"tags\": [\n {\n \"key\": \"Division\",\n \"value\": \"payments\"\n },\n {\n \"key\": \"Owner\",\n \"value\": \"platform-team\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"tags": [
{
"key": "Division",
"value": "payments",
"source": "user-defined"
},
{
"key": "Owner",
"value": "platform-team",
"source": "user-defined"
},
{
"key": "Environment",
"value": "prod",
"source": "cloud-provider"
}
]
}
}{
"errors": [
{
"field": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"message": "Internal server error"
}Replace an integration's user-defined tags
Replace the tags you define on an inbound integration in Plerion. Send the full list; an empty list removes them all. These tags feed integration groups together with the tags read from the cloud account, and a tag you define here replaces the cloud account tag with the same key. Prefer tagging the account in your cloud provider, where Plerion keeps the tags in sync automatically, and use this when that is not an option.
curl --request PUT \
--url https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: <content-type>' \
--data '
{
"tags": [
{
"key": "Division",
"value": "payments"
},
{
"key": "Owner",
"value": "platform-team"
}
]
}
'import requests
url = "https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags"
payload = { "tags": [
{
"key": "Division",
"value": "payments"
},
{
"key": "Owner",
"value": "platform-team"
}
] }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "<content-type>"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': '<content-type>'},
body: JSON.stringify({
tags: [{key: 'Division', value: 'payments'}, {key: 'Owner', value: 'platform-team'}]
})
};
fetch('https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'tags' => [
[
'key' => 'Division',
'value' => 'payments'
],
[
'key' => 'Owner',
'value' => 'platform-team'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: <content-type>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags"
payload := strings.NewReader("{\n \"tags\": [\n {\n \"key\": \"Division\",\n \"value\": \"payments\"\n },\n {\n \"key\": \"Owner\",\n \"value\": \"platform-team\"\n }\n ]\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "<content-type>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "<content-type>")
.body("{\n \"tags\": [\n {\n \"key\": \"Division\",\n \"value\": \"payments\"\n },\n {\n \"key\": \"Owner\",\n \"value\": \"platform-team\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{region}.api.plerion.com/v1/tenant/integrations/{integrationId}/user-defined-tags")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = '<content-type>'
request.body = "{\n \"tags\": [\n {\n \"key\": \"Division\",\n \"value\": \"payments\"\n },\n {\n \"key\": \"Owner\",\n \"value\": \"platform-team\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"data": {
"tags": [
{
"key": "Division",
"value": "payments",
"source": "user-defined"
},
{
"key": "Owner",
"value": "platform-team",
"source": "user-defined"
},
{
"key": "Environment",
"value": "prod",
"source": "cloud-provider"
}
]
}
}{
"errors": [
{
"field": "<string>",
"code": "<string>",
"message": "<string>"
}
]
}{
"errors": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"message": "Internal server error"
}Authorizations
Bearer API Key. For example, "Bearer {Tenant API Key}"
Headers
Bearer API Key. For example, "Bearer {Tenant API Key}"
application/json
Path Parameters
Integration ID.
"31497927-86af-4fba-afc6-c0cf2311a55b"
Body
The full list of user-defined tags. Keys must be unique and are case-sensitive.
50Show child attributes
Show child attributes
Response
The integration's tags after the change, user-defined first.
Show child attributes
Show child attributes
Was this page helpful?