curl --request POST \
--url https://telemetry.{region}.basaltic.sh/v1/log-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
'import requests
url = "https://telemetry.{region}.basaltic.sh/v1/log-groups"
payload = {
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
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({
name: 'app/prod/api',
description: 'Production API request logs',
retention_days: 30,
kms_key: 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
tags: {}
})
};
fetch('https://telemetry.{region}.basaltic.sh/v1/log-groups', 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://telemetry.{region}.basaltic.sh/v1/log-groups",
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([
'name' => 'app/prod/api',
'description' => 'Production API request logs',
'retention_days' => 30,
'kms_key' => 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
'tags' => [
]
]),
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://telemetry.{region}.basaltic.sh/v1/log-groups"
payload := strings.NewReader("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\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://telemetry.{region}.basaltic.sh/v1/log-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://telemetry.{region}.basaltic.sh/v1/log-groups")
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 \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}"
response = http.request(request)
puts response.read_body{
"log_group": {
"id": "4a7b2c8d-9e1f-4a2b-8c3d-5e6f7a8b9c0d",
"crn": "crn:telemetry:sa-saopaulo-1:my-account:log-group/app-prod-api",
"name": "app/prod/api",
"retention_days": 30,
"tags": {},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"kms_key": {
"id": "288aa1e9-bbf5-5584-bce9-6a688f06d8a1",
"crn": "crn:catalog::platform:country/288aa1e9-bbf5-5584-bce9-6a688f06d8a1",
"name": "Brazil"
},
"description": "Production API request logs"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Resource with this name already exists",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}Create a log group
Register a new log group in the caller’s org. Name is the
customer-visible identifier (1–512 chars of A-Za-z0-9_./#-)
and is immutable. Requires telemetry:CreateLogGroup.
curl --request POST \
--url https://telemetry.{region}.basaltic.sh/v1/log-groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
'import requests
url = "https://telemetry.{region}.basaltic.sh/v1/log-groups"
payload = {
"name": "app/prod/api",
"description": "Production API request logs",
"retention_days": 30,
"kms_key": "crn:kms:sa-saopaulo-1:my-account:key/service-key",
"tags": {}
}
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({
name: 'app/prod/api',
description: 'Production API request logs',
retention_days: 30,
kms_key: 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
tags: {}
})
};
fetch('https://telemetry.{region}.basaltic.sh/v1/log-groups', 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://telemetry.{region}.basaltic.sh/v1/log-groups",
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([
'name' => 'app/prod/api',
'description' => 'Production API request logs',
'retention_days' => 30,
'kms_key' => 'crn:kms:sa-saopaulo-1:my-account:key/service-key',
'tags' => [
]
]),
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://telemetry.{region}.basaltic.sh/v1/log-groups"
payload := strings.NewReader("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\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://telemetry.{region}.basaltic.sh/v1/log-groups")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://telemetry.{region}.basaltic.sh/v1/log-groups")
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 \"name\": \"app/prod/api\",\n \"description\": \"Production API request logs\",\n \"retention_days\": 30,\n \"kms_key\": \"crn:kms:sa-saopaulo-1:my-account:key/service-key\",\n \"tags\": {}\n}"
response = http.request(request)
puts response.read_body{
"log_group": {
"id": "4a7b2c8d-9e1f-4a2b-8c3d-5e6f7a8b9c0d",
"crn": "crn:telemetry:sa-saopaulo-1:my-account:log-group/app-prod-api",
"name": "app/prod/api",
"retention_days": 30,
"tags": {},
"created_at": "2026-01-15T09:30:00Z",
"updated_at": "2026-01-15T09:30:00Z",
"kms_key": {
"id": "288aa1e9-bbf5-5584-bce9-6a688f06d8a1",
"crn": "crn:catalog::platform:country/288aa1e9-bbf5-5584-bce9-6a688f06d8a1",
"name": "Brazil"
},
"description": "Production API request logs"
}
}{
"error": {
"code": "INVALID_INPUT",
"message": "Invalid request parameters",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "ACCESS_DENIED",
"message": "You don't have permission to perform this action",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "CONFLICT",
"message": "Resource with this name already exists",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "IDEMPOTENCY_KEY_REUSED",
"message": "This Idempotency-Key was already used with a different request payload",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "An internal error occurred",
"request_id": "550e8400-e29b-41d4-a716-446655440000"
}
}telemetry:CreateLogGroup. See TELEMETRY permissions for the full list, what each one covers, and an example policy.Authorizations
An OAuth 2.0 bearer token, sent as Authorization: Bearer <token>.
This is the recommended way to authenticate.
Get one by exchanging a service account's access key pair at
POST /v1/oauth/token with grant_type=client_credentials. It is the
standard client-credentials grant, so any OAuth-aware library will
obtain and refresh it for you.
curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
https://iam.basaltic.sh/v1/oauth/token
Tokens last an hour by default. The same access key pair is separately your AWS SigV4 credential for the S3-compatible object endpoint, which speaks nothing else.
Headers
Optional client-generated key that makes a create replay-safe. Retrying a request with the same key returns the original outcome verbatim instead of creating a duplicate resource. Reusing a key with a different request body is rejected (422); a request whose key is still being processed returns 409. Records are honored for 24 hours. Use a UUID or similarly unique token.
255Body
Resource names must not start with the literal crn: prefix or be UUIDs (canonical, compact, braced, or urn:uuid: forms, in either case).
"app/prod/api"
"Production API request logs"
Retention in days. Omit or use null for no expiry.
1, 3, 5, 7, 14, 30, 60, 90, 120, 150, 180, 365, 400, 545, 731, 1096, 1827, 2192, 2557, 2922, 3288, 3653, null 30
KMS key UUID, CRN or exact name in the authenticated account and serving region. The resolved UUID is pinned; deleting a key and reusing its name never retargets existing data. An empty string selects plaintext.
"crn:kms:sa-saopaulo-1:my-account:key/service-key"
Show child attributes
Show child attributes
Response
Log group created
Show child attributes
Show child attributes

