Create forwarding endpoint

curl --request POST \ --url https://api.coreweave.com/v1beta1/telemetryrelay/endpoints \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "ref": { "slug": "audit-https" }, "spec": { "displayName": "HTTPS audit logs", "https": { "endpoint": "https://receiver.example.com/logs", "compression": "COMPRESSION_TYPE_GZIP" } }, "https": { "authHeaders": { "headers": { "Authorization": "Bearer [DESTINATION-TOKEN]" } } } } '

{ "endpoint": { "ref": { "slug": "<string>" }, "spec": { "displayName": "<string>", "s3": { "uri": "<string>", "region": "<string>" }, "https": { "endpoint": "<string>", "tls": { "certificateAuthorityData": "<string>" }, "compression": "COMPRESSION_TYPE_UNSPECIFIED" } }, "status": { "createdAt": "2023-11-07T05:31:56Z", "updatedAt": "2023-11-07T05:31:56Z", "state": "FORWARDING_ENDPOINT_STATE_UNSPECIFIED", "stateMessage": "<string>", "zonesActive": [ { "zoneSlug": "<string>", "clusters": [ { "id": "<string>" } ] } ], "credentialsConfigured": true, "credentialsUpdatedAt": "2023-11-07T05:31:56Z" } } }

Authorizations

Authorization

string

header

default:Bearer [CW-API-TOKEN]

required

CoreWeave API access token sent as a bearer token.

Body

application/json

Option 1
Option 2

spec

object

required

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 afterward.

Option 1
Option 2

Show child attributes

ref

object

required

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

object

required

s3 credentials for AWS S3 destinations.

Show child attributes

https

object

https credentials for HTTPS endpoints, using basic auth or request headers.

Show child attributes

Response

endpoint

object

ForwardingEndpoint represents a destination where telemetry data can be forwarded. Endpoints are organization-scoped and identified by a unique slug. Endpoints forward to HTTPS endpoints or AWS S3 destinations.

Show child attributes