---
title: "Update Property Options"
method: POST
path: "/properties/{property_id}/options"
tags: ["custom properties"]
---

# Update Property Options

`POST /properties/{property_id}/options`

This endpoint adds or removes options on a dropdown or picklist custom property

To add options, pass the labels in `options` with `operation: add`. Adding is idempotent - re-adding an existing label is a no-op that returns its existing id, so you can safely keep the option list in sync with an external source of truth

To remove options, pass option ids or labels in `options` with `operation: remove`

_Removing an option is permanent. Tickets or chats currently set to a removed option will no longer resolve it to a label_

_If the same property name exists under both chat and ticket, pass the `type` query parameter to specify which one to update_

## Path parameters

- `property_id` string, required

## Query parameters

- `type` 'chat' | 'ticket'

## Request body

- object
  - `operation` 'add' | 'remove', required — - Whether to add or remove the given options
  - `options` string[], required — - For add: the labels to add - For remove: the option ids or labels to remove

## Response `200`

200 OK

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `property_id` string
    - `operation` 'add' | 'remove'
    - `options` object[] — The outcome for each option in the request, in order
      - `id` string — The id of the option. Absent when a remove entry did not match any option
      - `label` string
      - `added` boolean — Present for add. False means the label already existed and was left untouched
      - `removed` boolean — Present for remove. False means no option matched the entry

## Other responses

- `404` — No matching property
- `422` — Property has no option list

---

[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)