> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telemetry Relay API

> REST API for managing forwarding endpoints, pipelines, and telemetry streams for CoreWeave Telemetry Relay.

With an access token, you can interact with the Telemetry Relay API using `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](/observability/telemetry-forwarding/relay). For Cloud Console procedures, see [Configure Telemetry Relay](/observability/telemetry-forwarding/configure).

<Info>
  * 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](/security/authn-authz/manage-api-access-tokens).
  * 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](/security/iam/access-policies).
</Info>

<Note>
  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](/support) to request enablement.
</Note>

The API self-service scope is forwarding CoreWeave audit logs to your HTTPS destinations. For other telemetry or destinations, [contact Support](/support).

## Endpoints

The API exposes three resource families: **forwarding endpoints**, **forwarding pipelines**, and **telemetry streams**. Per-resource operations take the resource's `ref.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](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/list-forwarding-endpoints)           | `GET`    | `/v1beta1/telemetryrelay/endpoints`                  | List all forwarding endpoints.                       |
| [Create forwarding endpoint](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/create-forwarding-endpoint)         | `POST`   | `/v1beta1/telemetryrelay/endpoints`                  | Create a forwarding endpoint.                        |
| [Get forwarding endpoint](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/get-forwarding-endpoint)               | `GET`    | `/v1beta1/telemetryrelay/endpoints/{ref.slug}`       | Get a forwarding endpoint.                           |
| [Update forwarding endpoint](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/update-forwarding-endpoint)         | `PATCH`  | `/v1beta1/telemetryrelay/endpoints/{ref.slug}`       | Update a forwarding endpoint.                        |
| [Delete forwarding endpoint](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/delete-forwarding-endpoint)         | `DELETE` | `/v1beta1/telemetryrelay/endpoints/{ref.slug}`       | Delete a forwarding endpoint.                        |
| [Get forwarding endpoint status](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/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](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/list-forwarding-pipelines)   | `GET`    | `/v1beta1/telemetryrelay/pipelines`            | List all forwarding pipelines. |
| [Create forwarding pipeline](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/create-forwarding-pipeline) | `POST`   | `/v1beta1/telemetryrelay/pipelines`            | Create a forwarding pipeline.  |
| [Get forwarding pipeline](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/get-forwarding-pipeline)       | `GET`    | `/v1beta1/telemetryrelay/pipelines/{ref.slug}` | Get a forwarding pipeline.     |
| [Update forwarding pipeline](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/update-forwarding-pipeline) | `PATCH`  | `/v1beta1/telemetryrelay/pipelines/{ref.slug}` | Update a forwarding pipeline.  |
| [Delete forwarding pipeline](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/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](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/list-telemetry-streams) | `GET`  | `/v1beta1/telemetryrelay/streams`            | List all telemetry streams. |
| [Get telemetry stream](/observability/telemetry-forwarding/telemetry-relay-api/telemetryrelayservice/get-telemetry-stream)     | `GET`  | `/v1beta1/telemetryrelay/streams/{ref.slug}` | Get a telemetry stream.     |