curl or any other HTTP client. The API lets you manage forwarding endpoints and pipelines and list telemetry streams. These resources forward CoreWeave audit logs from the managed observability platform to your HTTPS destinations.
For a conceptual walkthrough of Telemetry Relay (what an endpoint, pipeline, and stream are, and how they wire together), see the CoreWeave Telemetry Relay overview. For Cloud Console procedures, see Configure Telemetry Relay.
- The API server is
https://api.coreweave.com. - Replace
[CW-API-TOKEN]in the examples on each operation page with your CoreWeave API access token. - Write operations (
POST,PATCH,DELETE) require the Telemetry Relay Admin role. Read operations (GET) require the Telemetry Relay Reader role. - For information on required permissions, see IAM Access Policies.
If you call a write operation (
POST, PATCH, DELETE) before your organization is enabled for self-service, the request returns 404 with "reason": "TELEMETRYRELAY_ORGANIZATION_NOT_FOUND". Contact Support to request enablement.Endpoints
The API exposes three resource families: forwarding endpoints, forwarding pipelines, and telemetry streams. Per-resource operations take the resource’sref.slug (a project-scoped human-readable name) as a path parameter, shown as {ref.slug} in the path templates below.
Forwarding endpoints
The following operations manage forwarding endpoints:| Operation | Method | Endpoint | Description |
|---|---|---|---|
| List forwarding endpoints | GET | /v1beta1/telemetryrelay/endpoints | List all forwarding endpoints. |
| Create forwarding endpoint | POST | /v1beta1/telemetryrelay/endpoints | Create a forwarding endpoint. |
| Get forwarding endpoint | GET | /v1beta1/telemetryrelay/endpoints/{ref.slug} | Get a forwarding endpoint. |
| Update forwarding endpoint | PATCH | /v1beta1/telemetryrelay/endpoints/{ref.slug} | Update a forwarding endpoint. |
| Delete forwarding endpoint | DELETE | /v1beta1/telemetryrelay/endpoints/{ref.slug} | Delete a forwarding endpoint. |
| Get forwarding endpoint status | GET | /v1beta1/telemetryrelay/endpoints/{ref.slug}:check | Read the last-known status of a forwarding endpoint. |
Forwarding pipelines
The following operations manage forwarding pipelines:| Operation | Method | Endpoint | Description |
|---|---|---|---|
| List forwarding pipelines | GET | /v1beta1/telemetryrelay/pipelines | List all forwarding pipelines. |
| Create forwarding pipeline | POST | /v1beta1/telemetryrelay/pipelines | Create a forwarding pipeline. |
| Get forwarding pipeline | GET | /v1beta1/telemetryrelay/pipelines/{ref.slug} | Get a forwarding pipeline. |
| Update forwarding pipeline | PATCH | /v1beta1/telemetryrelay/pipelines/{ref.slug} | Update a forwarding pipeline. |
| Delete forwarding pipeline | DELETE | /v1beta1/telemetryrelay/pipelines/{ref.slug} | Delete a forwarding pipeline. |
Telemetry streams
The following operations list and read telemetry streams:| Operation | Method | Endpoint | Description |
|---|---|---|---|
| List telemetry streams | GET | /v1beta1/telemetryrelay/streams | List all telemetry streams. |
| Get telemetry stream | GET | /v1beta1/telemetryrelay/streams/{ref.slug} | Get a telemetry stream. |