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

# Delete customer address

> Delete an address from the customer's address book.

**Soft Delete:**
This operation performs a soft delete - the address record is marked as deleted but retained in the database for audit purposes. Deleted addresses will not appear in list queries.

**Considerations:**
- Addresses referenced by existing invoices or contracts remain in those records
- Consider updating another address as default before deleting a default address
- Deleted addresses cannot be recovered through the API

**Requirements:**
- Address must exist and belong to the authenticated organization
- Valid UUID format required for both customer_id and address_id



## OpenAPI

````yaml /openAPI/openapi-20240301.json delete /customers/{customer_id}/addresses/{address_id}
openapi: 3.1.0
info:
  title: zenskar
  version: 2.0.0
servers:
  - url: https://api.zenskar.com
security:
  - ApiTokenAuth: []
    OrganisationAuth: []
paths:
  /customers/{customer_id}/addresses/{address_id}:
    delete:
      tags:
        - Customer Addresses
      summary: Delete customer address
      description: >-
        Delete an address from the customer's address book.


        **Soft Delete:**

        This operation performs a soft delete - the address record is marked as
        deleted but retained in the database for audit purposes. Deleted
        addresses will not appear in list queries.


        **Considerations:**

        - Addresses referenced by existing invoices or contracts remain in those
        records

        - Consider updating another address as default before deleting a default
        address

        - Deleted addresses cannot be recovered through the API


        **Requirements:**

        - Address must exist and belong to the authenticated organization

        - Valid UUID format required for both customer_id and address_id
      operationId: Delete-customer-address
      parameters:
        - name: customer_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Customer Id
        - name: address_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Address Id
      responses:
        '200':
          description: Successfully deleted customer address
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteCustomerAddressResponseSchema'
              example:
                id: 123e4567-e89b-12d3-a456-426614174000
                message: Address deleted
        '404':
          description: Address not found
          content:
            application/json:
              example:
                error_code: CUSTOMER_ADDRESS_NOT_FOUND
                message: customer address not found
        '422':
          description: Unprocessable Entity - invalid UUID
          content:
            application/json:
              example:
                status_code: 10422
                message: >-
                  1 validation error for Path; address_id: value is not a valid
                  uuid
        '500':
          description: Internal server error
          content:
            application/json:
              example:
                error_code: INTERNAL_SERVER_ERROR
                message: Failed to delete customer address
components:
  schemas:
    DeleteCustomerAddressResponseSchema:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Address ID
        message:
          type: string
          title: Message
          description: Deletion message
      type: object
      required:
        - id
        - message
      title: DeleteCustomerAddressResponseSchema
      description: Delete Customer Address Response Schema
  securitySchemes:
    ApiTokenAuth:
      type: apiKey
      in: header
      name: x-api-key
      x-default: <your-api-key>
    OrganisationAuth:
      type: apiKey
      in: header
      name: organisation
      x-default: <your-organisation-id>

````