Create a service binding
curl --request POST \
--url https://sreagent.app/api/v1/config/service_bindings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"service": "<string>",
"account_id": "<string>",
"environment": "<string>",
"log_filter": "<string>",
"log_groups": [
"<string>"
],
"metric_selectors": [
{
"dimensions": [
{
"name": "<string>",
"value": "<string>"
}
],
"metric_name": "<string>",
"namespace": "<string>"
}
],
"region": "<string>",
"trace_service_names": [
"<string>"
]
}
'import requests
url = "https://sreagent.app/api/v1/config/service_bindings"
payload = {
"service": "<string>",
"account_id": "<string>",
"environment": "<string>",
"log_filter": "<string>",
"log_groups": ["<string>"],
"metric_selectors": [
{
"dimensions": [
{
"name": "<string>",
"value": "<string>"
}
],
"metric_name": "<string>",
"namespace": "<string>"
}
],
"region": "<string>",
"trace_service_names": ["<string>"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
service: '<string>',
account_id: '<string>',
environment: '<string>',
log_filter: '<string>',
log_groups: ['<string>'],
metric_selectors: [
{
dimensions: [{name: '<string>', value: '<string>'}],
metric_name: '<string>',
namespace: '<string>'
}
],
region: '<string>',
trace_service_names: ['<string>']
})
};
fetch('https://sreagent.app/api/v1/config/service_bindings', 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://sreagent.app/api/v1/config/service_bindings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'service' => '<string>',
'account_id' => '<string>',
'environment' => '<string>',
'log_filter' => '<string>',
'log_groups' => [
'<string>'
],
'metric_selectors' => [
[
'dimensions' => [
[
'name' => '<string>',
'value' => '<string>'
]
],
'metric_name' => '<string>',
'namespace' => '<string>'
]
],
'region' => '<string>',
'trace_service_names' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://sreagent.app/api/v1/config/service_bindings"
payload := strings.NewReader("{\n \"service\": \"<string>\",\n \"account_id\": \"<string>\",\n \"environment\": \"<string>\",\n \"log_filter\": \"<string>\",\n \"log_groups\": [\n \"<string>\"\n ],\n \"metric_selectors\": [\n {\n \"dimensions\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"metric_name\": \"<string>\",\n \"namespace\": \"<string>\"\n }\n ],\n \"region\": \"<string>\",\n \"trace_service_names\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sreagent.app/api/v1/config/service_bindings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"service\": \"<string>\",\n \"account_id\": \"<string>\",\n \"environment\": \"<string>\",\n \"log_filter\": \"<string>\",\n \"log_groups\": [\n \"<string>\"\n ],\n \"metric_selectors\": [\n {\n \"dimensions\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"metric_name\": \"<string>\",\n \"namespace\": \"<string>\"\n }\n ],\n \"region\": \"<string>\",\n \"trace_service_names\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sreagent.app/api/v1/config/service_bindings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"service\": \"<string>\",\n \"account_id\": \"<string>\",\n \"environment\": \"<string>\",\n \"log_filter\": \"<string>\",\n \"log_groups\": [\n \"<string>\"\n ],\n \"metric_selectors\": [\n {\n \"dimensions\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"metric_name\": \"<string>\",\n \"namespace\": \"<string>\"\n }\n ],\n \"region\": \"<string>\",\n \"trace_service_names\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"error": "<string>",
"message": "<string>"
}service_bindings
Create a service binding
Correct what a service is called in one telemetry backend: the log groups, log filter, X-Ray service names and metric selectors the Explorer binds for service (and environment, default ""), overriding AWS discovery and the OpenTelemetry convention. An OMITTED column keeps its stored value (or stays unbound, for a fresh binding); log_groups, trace_service_names and metric_selectors each REPLACE the stored list when named, so an empty array deliberately overrides that column to nothing rather than leaving it alone. resolve_service_bindings shows the difference as origin “override” with an empty value, versus falling through to discovery or the convention. An empty log_filter clears it back to unbound (there is no way to bind an empty filter on purpose). account_id and region pin where the service lives, so logs and metrics search only there (traces always search every account); null clears either. Audited, and this organization’s discovery cache is invalidated so the next read reflects it immediately.
POST
/
service_bindings
Create a service binding
curl --request POST \
--url https://sreagent.app/api/v1/config/service_bindings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"service": "<string>",
"account_id": "<string>",
"environment": "<string>",
"log_filter": "<string>",
"log_groups": [
"<string>"
],
"metric_selectors": [
{
"dimensions": [
{
"name": "<string>",
"value": "<string>"
}
],
"metric_name": "<string>",
"namespace": "<string>"
}
],
"region": "<string>",
"trace_service_names": [
"<string>"
]
}
'import requests
url = "https://sreagent.app/api/v1/config/service_bindings"
payload = {
"service": "<string>",
"account_id": "<string>",
"environment": "<string>",
"log_filter": "<string>",
"log_groups": ["<string>"],
"metric_selectors": [
{
"dimensions": [
{
"name": "<string>",
"value": "<string>"
}
],
"metric_name": "<string>",
"namespace": "<string>"
}
],
"region": "<string>",
"trace_service_names": ["<string>"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
service: '<string>',
account_id: '<string>',
environment: '<string>',
log_filter: '<string>',
log_groups: ['<string>'],
metric_selectors: [
{
dimensions: [{name: '<string>', value: '<string>'}],
metric_name: '<string>',
namespace: '<string>'
}
],
region: '<string>',
trace_service_names: ['<string>']
})
};
fetch('https://sreagent.app/api/v1/config/service_bindings', 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://sreagent.app/api/v1/config/service_bindings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'service' => '<string>',
'account_id' => '<string>',
'environment' => '<string>',
'log_filter' => '<string>',
'log_groups' => [
'<string>'
],
'metric_selectors' => [
[
'dimensions' => [
[
'name' => '<string>',
'value' => '<string>'
]
],
'metric_name' => '<string>',
'namespace' => '<string>'
]
],
'region' => '<string>',
'trace_service_names' => [
'<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$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://sreagent.app/api/v1/config/service_bindings"
payload := strings.NewReader("{\n \"service\": \"<string>\",\n \"account_id\": \"<string>\",\n \"environment\": \"<string>\",\n \"log_filter\": \"<string>\",\n \"log_groups\": [\n \"<string>\"\n ],\n \"metric_selectors\": [\n {\n \"dimensions\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"metric_name\": \"<string>\",\n \"namespace\": \"<string>\"\n }\n ],\n \"region\": \"<string>\",\n \"trace_service_names\": [\n \"<string>\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://sreagent.app/api/v1/config/service_bindings")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"service\": \"<string>\",\n \"account_id\": \"<string>\",\n \"environment\": \"<string>\",\n \"log_filter\": \"<string>\",\n \"log_groups\": [\n \"<string>\"\n ],\n \"metric_selectors\": [\n {\n \"dimensions\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"metric_name\": \"<string>\",\n \"namespace\": \"<string>\"\n }\n ],\n \"region\": \"<string>\",\n \"trace_service_names\": [\n \"<string>\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sreagent.app/api/v1/config/service_bindings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"service\": \"<string>\",\n \"account_id\": \"<string>\",\n \"environment\": \"<string>\",\n \"log_filter\": \"<string>\",\n \"log_groups\": [\n \"<string>\"\n ],\n \"metric_selectors\": [\n {\n \"dimensions\": [\n {\n \"name\": \"<string>\",\n \"value\": \"<string>\"\n }\n ],\n \"metric_name\": \"<string>\",\n \"namespace\": \"<string>\"\n }\n ],\n \"region\": \"<string>\",\n \"trace_service_names\": [\n \"<string>\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"error": "<string>",
"message": "<string>"
}Authorizations
An sre_ak_* API key holding the api:admin scope (or api:config_read, which every write refuses with read_only_key).
Body
application/json
The service to bind.
AWS account (twelve digits) the service lives in; null searches every account.
Default "", meaning no particular environment.
A Logs Insights filter fragment. "" clears it.
CloudWatch log group names, replacing the stored list.
{namespace, metric_name, dimensions?: [{name, value}]} objects, replacing the stored list.
Show child attributes
Show child attributes
AWS region the service lives in, for example us-east-1; null searches every region.
X-Ray service names, replacing the stored list.
Response
Created.