---
title: "Delete Custom Properties"
method: DELETE
path: "/properties"
tags: ["custom properties"]
---

# Delete Custom Properties

`DELETE /properties`

This endpoint deletes one or more custom properties

Pass the ids or names of the properties to delete in `ticket_properties` and/or `chat_properties`. At least one of the two must be provided

_Deleting a property is permanent. Any values set for it on tickets or chats are orphaned_

_Entries that do not match any property are reported with `deleted: false` and a reason, without failing the rest of the request_

## Request body

- object
  - `ticket_properties` string[] — - The ids or names of the ticket properties to delete
  - `chat_properties` string[] — - The ids or names of the chat properties to delete

## Response `200`

200 OK

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `deleted_count` integer — The number of properties that were deleted
    - `properties` object[] — The outcome for each entry in the request, in order
      - `property_ref` string — The id or name exactly as it was passed in the request
      - `property_id` string — The id of the deleted property. Absent when the entry did not match
      - `deleted` boolean
      - `reason` string — Why the entry was not deleted. Present only when deleted is false

## Other responses

- `422` — No properties provided

---

[API](https://skmtc.net/periskope/apis/api-local.md) · [All operations](https://skmtc.net/periskope/apis/api-local/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/periskope/api-local/versions/f2738ced87d8/schema)