Skip to main content
TypeScript

Authorizations

Authorization
string
header
required

Your Periskope API token, sent as Authorization: Bearer <token>. Generate one from the Periskope dashboard under Settings → API & Webhooks. API access requires an active Pro or Enterprise plan.

Path Parameters

property_id
string
required

The property_id (property-xxxxxxxxxxxxxxxx) or the name (case-insensitive) of the custom property. Prefer the property_id — a name that exists as both a chat and a ticket property is ambiguous without the type query parameter.

Minimum string length: 1
Example:

"property-aaaaaaaaaaaa"

Query Parameters

type
enum<string>

Resolves the chat or the ticket property when property_id is a name that exists as both. Not needed when passing a property_id, or when the name only exists under one type.

Available options:
chat,
ticket
Example:

"ticket"

Body

application/json
name
string

New name for the property. Must be unique within the property’s type (compared case-insensitively, stored trimmed).

Minimum string length: 1
Example:

"Customer Workspace"

section
string | null

Name of the section to move the property to. Matched case-insensitively; created automatically if it does not exist. Pass null or an empty string to remove the property from its current section.

Example:

"Issue Details"

mandatory
boolean

Whether the property must be filled in. Supported only for ticket properties — mandatory: true for a chat property is rejected.

Example:

true

Response

The updated property

success
enum<boolean>

Always true when the property was updated

Available options:
true
message
string

Human-readable confirmation message

Example:

"Custom property updated"

data
object

The updated property