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

# Delete Location

> Permanently delete a location.

Permanently delete a location. Deletion is immediate and **cannot be undone** —
any transfer that resolves to it will stop authenticating. A successful delete
returns `204 No Content`.

Address the location by **`name`** or **`id`** in the request body; at least one
is required. A non-unique `name` returns `409` with the candidates — resend with
the `id` of the one you want.

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.byteport.com/v1/locations \
    -H "Authorization: Bearer $BYTEPORT_API_KEY" \
    -H "User-Agent: my-app/1.0" \
    -H "Content-Type: application/json" \
    -d '{ "id": "3f9a2b7c-1d4e-4a8f-9c2b-6e5d0a1f7b83" }'
  ```

  ```javascript JavaScript theme={null}
  await fetch("https://api.byteport.com/v1/locations", {
    method: "DELETE",
    headers: {
      Authorization: `Bearer ${process.env.BYTEPORT_API_KEY}`,
      "User-Agent": "my-app/1.0",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ id: "3f9a2b7c-1d4e-4a8f-9c2b-6e5d0a1f7b83" }), // or { name: "..." }
  });
  ```

  ```python Python theme={null}
  import os, requests

  requests.delete(
      "https://api.byteport.com/v1/locations",
      headers={
          "Authorization": f"Bearer {os.environ['BYTEPORT_API_KEY']}",
          "User-Agent": "my-app/1.0",
      },
      json={"id": "3f9a2b7c-1d4e-4a8f-9c2b-6e5d0a1f7b83"},  # or {"name": "..."}
  )
  ```
</RequestExample>

<ResponseExample>
  ```text 204 No Content theme={null}
  (empty body)
  ```

  ```json 409 Conflict theme={null}
  {
    "error": "name is not unique; re-issue with an \"id\" field for one of the candidates",
    "name":  "prod-backups",
    "candidates": [
      {
        "id":         "3f9a2b7c-1d4e-4a8f-9c2b-6e5d0a1f7b83",
        "provider":   "s3",
        "created_at": "2026-05-14T17:02:11Z",
        "updated_at": "2026-06-01T09:44:20Z"
      },
      {
        "id":         "8c2e1f4a-9b3d-4e6f-a1c7-2d5b0e9f7a34",
        "provider":   "gcs",
        "created_at": "2026-05-20T11:07:33Z",
        "updated_at": "2026-05-20T11:07:33Z"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml DELETE /v1/locations
openapi: 3.1.0
info:
  title: Byteport API
  description: >-
    The Byteport API lets you move, share, and manage files across every storage
    location connected to your workspace through a single HTTP interface.
  version: 1.0.0
servers:
  - url: https://api.byteport.com
security:
  - bearerAuth: []
paths:
  /v1/locations:
    delete:
      summary: Delete Location
      description: >-
        Permanently delete a location, addressed by `name` or `id`. This is
        immediate and cannot be undone; any transfer that resolves to it will
        stop authenticating.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Address the location by `name` or `id`.
              properties:
                name:
                  type: string
                  description: >-
                    The location name (its `label`). Resolved to a single
                    location; if the name matches several, also send `id` to
                    pick one.
                  example: prod-backups
                id:
                  type: string
                  description: >-
                    The location's UUID. Addresses one location directly, or —
                    alongside `name` — selects which match of a non-unique name
                    to act on.
                  example: 3f9a2b7c-1d4e-4a8f-9c2b-6e5d0a1f7b83
      responses:
        '204':
          description: Location deleted. The response body is empty.
        '400':
          $ref: '#/components/responses/Error'
        '401':
          $ref: '#/components/responses/Error'
        '404':
          $ref: '#/components/responses/Error'
        '409':
          description: The `name` matches more than one location; resend with an `id`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LocationConflict'
components:
  responses:
    Error:
      description: Unexpected error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    LocationConflict:
      type: object
      description: >-
        Returned with `409` by a single-location endpoint when the `name` in the
        body matches more than one location. Re-issue the request with an `id`
        field set to one of the candidates.
      properties:
        error:
          type: string
          description: Human-readable explanation of the ambiguity.
          example: >-
            name is not unique; re-issue with an "id" field for one of the
            candidates
        name:
          type: string
          description: The ambiguous location name from the request body.
          example: prod-backups
        candidates:
          type: array
          description: >-
            Every location that carries this name. Choose one and resend with
            its `id`.
          items:
            $ref: '#/components/schemas/LocationRef'
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: integer
        message:
          type: string
    LocationRef:
      type: object
      description: >-
        A credential addressed by its label ("location name"). Because labels
        are not unique, a single name can resolve to several of these.
        `provider` and the timestamps let you tell same-named credentials apart
        and pick the `id` to act on.
      properties:
        id:
          type: string
          description: >-
            The credential's UUID. Pass it back as the `?id=` query parameter to
            disambiguate a non-unique name on the mutating Locations endpoints.
          example: 3f9a2b7c-1d4e-4a8f-9c2b-6e5d0a1f7b83
        provider:
          type: string
          description: The storage backend this credential authenticates against.
          example: s3
        created_at:
          type: string
          format: date-time
          description: When the credential was created (RFC 3339, UTC).
          example: '2026-05-14T17:02:11Z'
        updated_at:
          type: string
          format: date-time
          description: When the credential was last modified (RFC 3339, UTC).
          example: '2026-06-01T09:44:20Z'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````