---
title: "Delete gateway"
method: DELETE
path: "/v1alpha1/inference/gateways/{id}"
tags: ["GatewayService"]
---

# Delete gateway

`DELETE /v1alpha1/inference/gateways/{id}`

Deletes a gateway by ID. Returns the deleted gateway.

## Path parameters

- `id` string, required

## Response `200`

OK

- DeleteGatewayResponse — Response for DeleteGateway
  - `gateway` Gateway — Gateway object with specification and status fields
    - `spec` GatewaySpec — GatewaySpec contains the specification for a Gateway
      - `id` string — The unique identifier of the gateway, UUID format
      - `name` string — The human readable name of the gateway. Combined with organization_id and the deployment base domain it forms the gateway's public FQDN (<name>.<orgId>.gw.<baseDomain>). See CreateGatewayRequest.name and UpdateGatewayRequest.name for the length cap applied on write.
      - `zones` string[] — The Availability Zones the gateway is deployed in. The field accepts an array, but gateways are currently limited to one zone. The available zones are returned by `GET /v1alpha1/inference/gateways/parameters`.
      - `coreWeaveAuth` CoreWeaveAuth — Use CoreWeave IAM authentication, no additional configuration
      - `weightsAndBiasesAuth` WeightsAndBiasesAuth — Use W&B auth
        - `apiKey` string — The W&B organization API key. Required if `serverUrl` is set.
        - `serverUrl` string — Optional W&B server URL. Defaults to the W&B shared SaaS instance.
        - `enableUsageReports` boolean — Send inference usage data to W&B for tracking.
        - `enableRateLimiting` boolean — Enable W&B-controlled rate limiting for inference requests.
      - `organizationId` string — The organization ID that owns the gateway
      - `endpointConfiguration` EndpointConfiguration — Configuration options for the gateway endpoint, DNS, TLS, etc.
        - `additionalDns` string[] — Additional DNS configurations, these DNS need to be configured to point to the gateway endpoint manually
      - `bodyBasedRouting` BodyBasedRouting — Body based routing configuration
        - `apiType` 'API_TYPE_OPENAI', required — Well-known API type for routing. `API_TYPE_OPENAI` extracts the model name from the `model` field in the JSON request body (OpenAI-compatible behavior).
      - `headerBasedRouting` HeaderBasedRouting — Header based routing configuration, uses a header value to route requests to the model by name
        - `headerName` string, required — The HTTP header to read the model name from on each inference request. Must be 1-100 characters.
      - `pathBasedRouting` PathBasedRouting — Path-based routing configuration. The model name is read from the first segment of the URL path (for example, `/my-model/v1/chat/completions`). URL-encode model names that contain special characters.
    - `status` GatewayStatus — GatewayStatus contains the status fields for a Gateway
      - `createdAt` string, date-time — The time at which the gateway was created.
      - `updatedAt` string, date-time — The time at which the gateway was last updated.
      - `conditions` Condition[] — List of conditions representing detailed status information
        - `type` string — Type of condition
        - `lastUpdateTime` string, date-time — Last time the condition was updated
        - `reason` string — Reason for the condition's last transition
        - `message` string — Human-readable message indicating details about the condition
        - `zone` string — Zone associated with the condition
        - `status` 'True' | 'False' | 'Unknown' — Whether the condition is currently `True`, `False`, or `Unknown`. Mirrors the Kubernetes condition convention.
      - `endpoints` string[] — The endpoint URLs for the gateway. The default endpoint follows the pattern `https://api.[GATEWAY-ID].gw.cwinference.com`; additional entries appear when `endpointConfiguration.additionalDns` is set.
      - `status` 'STATUS_CREATING' | 'STATUS_READY' | 'STATUS_UPDATING' | 'STATUS_DELETING' | 'STATUS_ERROR' — The overall status of the gateway. See the [Inference API overview](https://docs.coreweave.com/products/inference/reference/api-overview#status-values) for the meaning of each value. Once `STATUS_READY`, the gateway exposes one or more endpoint URLs in `endpoints`.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api.md) · [All operations](https://skmtc.dev/coreweave/apis/coreweave-telemetry-relay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coreweave/coreweave-telemetry-relay-api/revisions/3b98ea4fe0c3/schema)