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

# Delete a property

> Deletes the property associated with the given ID.




## OpenAPI

````yaml openapi.yaml delete /delete-property/{propertyId}
openapi: 3.1.0
info:
  title: Housr API
  version: 1.0.0
  summary: Property management API with hourly-expiring bearer token authentication.
  description: >
    This API provides endpoints for managing properties in the Housr platform.
    It issues an hourly-expiring bearer token via HTTP Basic Auth for secure
    access. Unless otherwise noted, all endpoints require `Authorization: Bearer
    <token>` over HTTPS.


    ## Endpoints


    ### Health Check

    - `GET /health-check` - Check API service availability (no authentication
    required)


    ### Authentication

    - `POST /auth/token` - Obtain a bearer token using HTTP Basic Auth
      - Token expires in 1 hour by default
      - Token provides access based on client credentials and associated scopes

    ### Properties

    - `GET /get-property/{propertyId}` - Retrieve a property by ID
      - Requires bearer token authentication
    - `POST /create-property` - Create a new property record
      - Requires `properties:write` scope
      - Accepts JSON or form-encoded data
      - Supports image URLs as array or comma-separated string
    - `PATCH /update-property/{propertyId}` - Update an existing property
      - Requires `properties:write` scope
      - Server enforces ownership/permissions
      - Provide only fields you wish to change
    - `DELETE /delete-property/{propertyId}` - Delete a property
      - Requires `properties:delete` scope
      - Server enforces ownership/permissions

    ## Authentication

    - Obtain a token with Basic Auth to `/auth/token`.

    - Token expires in 1 hour by default.

    - Use the token in subsequent requests: `Authorization: Bearer <token>`


    ## Error Responses

    All error responses follow the `application/problem+json` format with a
    `response` field containing the error message. Validation errors include an
    additional `errors` object with field-specific error arrays.
servers:
  - url: https://v2.api.uk.housr.com
    description: Production
  - url: https://v2.staging.api.uk.housr.com
    description: Sandbox
security:
  - bearerAuth: []
tags:
  - name: Auth
  - name: Properties
  - name: Health Check
paths:
  /delete-property/{propertyId}:
    delete:
      tags:
        - Properties
      summary: Delete a property
      description: |
        Deletes the property associated with the given ID.
      parameters:
        - $ref: '#/components/parameters/PropertyId'
      responses:
        '200':
          description: Deleted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageResponse'
              examples:
                ok:
                  value:
                    message: Property successfully deleted
        '401':
          description: Missing or invalid authentication
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
              examples:
                unauthorized:
                  value:
                    response: Missing or invalid authentication token
        '403':
          description: Authenticated but not allowed
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
              examples:
                forbidden:
                  value:
                    response: You do not have permission to perform this action
        '404':
          description: Resource not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
              examples:
                not_found:
                  value:
                    response: Property with ID 12345 not found
      security:
        - bearerAuth: []
components:
  parameters:
    PropertyId:
      in: path
      name: propertyId
      required: true
      schema:
        type: integer
        format: int64
      description: ID of the property
  schemas:
    MessageResponse:
      type: object
      properties:
        message:
          type: string
    Problem:
      type: object
      properties:
        response:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````