Skip to main content
PATCH
Edit a default service

Authorizations

Authorization
string
header
required

An API key from Settings → API Keys (starts with tikk_sk_), or an OAuth access token for a partner app. Both carry scopes; each endpoint lists the one it needs.

Path Parameters

id
integer
required

The service id, as returned by GET /services or POST /services. Slugs aren't accepted.

Body

application/json

The writable fields of a default service.

title
string
Maximum string length: 50
Example:

"Intro call"

description
string | null

Shown on the booking page.

Maximum string length: 500
slug
string

Lowercase letters, digits and single hyphens, unique among your services. Custom slugs need Pro: on Free the slug is generated from the title and a slug you send is ignored.

Maximum string length: 100
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"intro-call"

durations
object[]

Replaces all durations when sent.

Minimum array length: 1
is_group
boolean

Several people can book the same slot. Needs Pro; true on Free returns 422.

max_attendees
integer | null

Seat cap. Required when is_group is true.

Required range: 2 <= x <= 50
requires_approval
boolean

Accept each booking by hand. Needs Pro; on Free, bookings are always accepted automatically.

location
object

Replaces the location when sent.

Response

The updated service.

data
Default service · object
required

A permanent booking page, such as "Intro call".