curl --request POST \
--url https://api.coreweave.com/v1beta1/telemetryrelay/endpoints \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ref": {
"slug": "<string>"
},
"spec": {
"displayName": "<string>"
},
"https": {}
}
'import requests
url = "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints"
payload = {
"ref": { "slug": "<string>" },
"spec": { "displayName": "<string>" },
"https": {}
}
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({ref: {slug: '<string>'}, spec: {displayName: '<string>'}, https: {}})
};
fetch('https://api.coreweave.com/v1beta1/telemetryrelay/endpoints', 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://api.coreweave.com/v1beta1/telemetryrelay/endpoints",
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([
'ref' => [
'slug' => '<string>'
],
'spec' => [
'displayName' => '<string>'
],
'https' => [
]
]),
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://api.coreweave.com/v1beta1/telemetryrelay/endpoints"
payload := strings.NewReader("{\n \"ref\": {\n \"slug\": \"<string>\"\n },\n \"spec\": {\n \"displayName\": \"<string>\"\n },\n \"https\": {}\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://api.coreweave.com/v1beta1/telemetryrelay/endpoints")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ref\": {\n \"slug\": \"<string>\"\n },\n \"spec\": {\n \"displayName\": \"<string>\"\n },\n \"https\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coreweave.com/v1beta1/telemetryrelay/endpoints")
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 \"ref\": {\n \"slug\": \"<string>\"\n },\n \"spec\": {\n \"displayName\": \"<string>\"\n },\n \"https\": {}\n}"
response = http.request(request)
puts response.read_body{
"endpoint": {
"ref": {
"slug": "<string>"
},
"spec": {
"displayName": "<string>",
"https": {
"endpoint": "<string>",
"tls": {
"certificateAuthorityData": "<string>"
}
}
},
"status": {
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"stateMessage": "<string>",
"zonesActive": [
{
"zoneSlug": "<string>",
"clusters": [
{
"id": "<string>"
}
]
}
],
"credentialsConfigured": true,
"credentialsUpdatedAt": "2023-11-07T05:31:56Z"
}
}
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Create forwarding endpoint
Creates a forwarding endpoint. The request body must include ref.slug (the unique per-organization identifier), spec (display name plus exactly one protocol-specific config), and the matching credentials block in the same oneof. Credentials are stored encrypted and never returned in responses.
curl --request POST \
--url https://api.coreweave.com/v1beta1/telemetryrelay/endpoints \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"ref": {
"slug": "<string>"
},
"spec": {
"displayName": "<string>"
},
"https": {}
}
'import requests
url = "https://api.coreweave.com/v1beta1/telemetryrelay/endpoints"
payload = {
"ref": { "slug": "<string>" },
"spec": { "displayName": "<string>" },
"https": {}
}
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({ref: {slug: '<string>'}, spec: {displayName: '<string>'}, https: {}})
};
fetch('https://api.coreweave.com/v1beta1/telemetryrelay/endpoints', 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://api.coreweave.com/v1beta1/telemetryrelay/endpoints",
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([
'ref' => [
'slug' => '<string>'
],
'spec' => [
'displayName' => '<string>'
],
'https' => [
]
]),
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://api.coreweave.com/v1beta1/telemetryrelay/endpoints"
payload := strings.NewReader("{\n \"ref\": {\n \"slug\": \"<string>\"\n },\n \"spec\": {\n \"displayName\": \"<string>\"\n },\n \"https\": {}\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://api.coreweave.com/v1beta1/telemetryrelay/endpoints")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"ref\": {\n \"slug\": \"<string>\"\n },\n \"spec\": {\n \"displayName\": \"<string>\"\n },\n \"https\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coreweave.com/v1beta1/telemetryrelay/endpoints")
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 \"ref\": {\n \"slug\": \"<string>\"\n },\n \"spec\": {\n \"displayName\": \"<string>\"\n },\n \"https\": {}\n}"
response = http.request(request)
puts response.read_body{
"endpoint": {
"ref": {
"slug": "<string>"
},
"spec": {
"displayName": "<string>",
"https": {
"endpoint": "<string>",
"tls": {
"certificateAuthorityData": "<string>"
}
}
},
"status": {
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"stateMessage": "<string>",
"zonesActive": [
{
"zoneSlug": "<string>",
"clusters": [
{
"id": "<string>"
}
]
}
],
"credentialsConfigured": true,
"credentialsUpdatedAt": "2023-11-07T05:31:56Z"
}
}
}{
"code": 123,
"message": "<string>",
"details": [
{
"@type": "<string>"
}
]
}Authorizations
CoreWeave API access token sent as a bearer token.
Body
ForwardingEndpointRef uniquely identifies a forwarding endpoint within an organization.
Endpoints are referenced by a human-readable slug that must be unique per organization.
Show child attributes
Show child attributes
Configuration for a forwarding endpoint. Includes a human-readable displayName and exactly one protocol-specific config. The protocol type is fixed at creation time and cannot be changed afterwards.
Show child attributes
Show child attributes
https credentials for HTTPS endpoints with basic auth.
Show child attributes
Show child attributes
Response
OK
ForwardingEndpoint represents a destination where telemetry data can be forwarded. Endpoints are organization-scoped and identified by a unique slug. Self-service endpoints forward over HTTPS.
Show child attributes
Show child attributes
Was this page helpful?