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

# Delete Route

> Permanently deletes a route and its associated telemetry data.



## OpenAPI

````yaml DELETE /v1/routes/{route_id}
openapi: 3.1.0
info:
  title: Motion Freight Router API
  description: >-
    Drop-in replacement for Google Routes API with segment-level physics
    enrichment for heavy freight. Provides both a Google-compatible synchronous
    endpoint and stateful route management endpoints.
  version: 1.0.0
  license:
    name: MIT
servers:
  - url: http://localhost:8000
    description: Local development
security: []
tags:
  - name: Google-Compatible
    description: Drop-in replacement for Google Routes API. Same request/response format.
  - name: Routes
    description: Stateful route management with sync/async computation.
  - name: Telemetry
    description: Segment-level physics telemetry data (grade, curvature, fuel burn).
  - name: Health
    description: API health and status.
paths:
  /v1/routes/{route_id}:
    delete:
      tags:
        - Routes
      summary: Delete Route
      description: Permanently deletes a route and its associated telemetry data.
      operationId: deleteRoute
      parameters:
        - name: route_id
          in: path
          required: true
          description: The unique route resource ID (prefixed with `route_`)
          schema:
            type: string
            example: route_01HYX3MPK5XJQJG0NB0PRSDVWC
      responses:
        '200':
          description: Route deleted successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: The deleted route ID
                    example: route_01HYX3MPK5XJQJG0NB0PRSDVWC
                  object:
                    type: string
                    enum:
                      - route
                    example: route
                  deleted:
                    type: boolean
                    example: true
                required:
                  - id
                  - object
                  - deleted
        '404':
          description: Route not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  type: invalid_request_error
                  code: route_not_found
                  message: Route route_01HYX3MPK5XJQJG0NB0PRSDVWC not found.
                  param: route_id
                  doc_url: null
components:
  schemas:
    ErrorResponse:
      type: object
      description: Structured error response.
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      required:
        - error
    ErrorDetail:
      type: object
      description: Error detail object
      properties:
        type:
          type: string
          enum:
            - invalid_request_error
            - routing_error
            - rate_limit_error
            - api_error
            - enrichment_error
          description: Error type category
        code:
          type: string
          description: Machine-readable error code
          example: route_not_found
        message:
          type: string
          description: Human-readable error message
        param:
          type: string
          nullable: true
          description: The parameter that caused the error
        doc_url:
          type: string
          nullable: true
          description: URL to relevant documentation
      required:
        - type
        - code
        - message

````