Skip to main content
PATCH
Update a landing page

Authorizations

Authorization
string
header
required

API key issued in the dashboard. Server-side only: never ship it to a browser, and never pass it as a query parameter.

Path Parameters

id
string
required
Example:

"lnd_5aec1b2c3d4e5f6a7b8c9d0e1f2a3b4c"

Body

application/json
bio
string | null
Maximum string length: 500
location
string | null
Maximum string length: 50
Example:

"Berlin"

banner_image_url
string<uri> | null

Banner behind the profile header. Must be a url from /v1/uploads .

background_video_url
string<uri> | null

Must be a url from /v1/uploads .

slug
string | null

Optional when using a custom domain, but only once. See How we build links.

Required string length: 3 - 25
Example:

"kate"

domain
string | null
default:teasy.link

Link domain you wish. Optional. If you don't provide one when creating, the system domain teasy.link will be used. The custom domain must be active to be used. See Custom Domains

Maximum string length: 253
Example:

"teasy.link"

group_id
string | null
Example:

"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"

note
string | null

Private note, never shown to visitors.

Maximum string length: 256
is_active
boolean
default:true
antibot_enabled
boolean
default:false

Blocks VPN and Proxy traffic to your link.

direct_button_enabled
boolean
default:false

It transforms your landing page to a social network page layout.

direct_button_text
string | null

Required when direct_button_enabled is true.

Required string length: 1 - 100
Example:

"Direct Message"

direct_button_url
string | null

Required when direct_button_enabled is true.

Maximum string length: 2048
Example:

"https://mycontent.com/kate"

socials
object[] | null

One account per network. Null or an empty array clears them.

Maximum array length: 15
pixels
object[] | null

One pixel per platform. Requires a plan with pixels.

Maximum array length: 4
geo_blocklists
object | null

Requires a plan with geo filtering.

tease_chat
object | null

Requires a plan with TeaseChat. Null clears the configuration.

title
string
Required string length: 1 - 100
Example:

"Kate"

avatar_url
string<uri>

A url returned by /v1/uploads. Cannot be cleared.

widgets
object[] | null

Order on the page follows the order of this array. Null or an empty array removes every widget.

Maximum array length: 20

Response

id
string
required
Example:

"lnd_5aec1b2c3d4e5f6a7b8c9d0e1f2a3b4c"

object
enum<string>
required
Available options:
landing
title
string
required
Example:

"Kate"

slug
string | null
required

Null when the link occupies the root of a custom domain.

Example:

"kate"

url
string | null
required

Public address, assembled from the domain and the slug. Null only if the link lost its domain.

Example:

"https://teasy.link/kate"

is_active
boolean
required
Example:

true

note
string | null
required

Private note, never shown to visitors.

group_id
string | null
required
Example:

"grp_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d"

domain
string | null
required

Hostname as a plain string — the same value is passed when creating a link.

Example:

"teasy.link"

created_at
string<date-time>
required
Example:

"2026-08-21T10:00:00Z"

updated_at
string<date-time>
required
Example:

"2026-08-21T10:00:00Z"

bio
string | null
required
location
string | null
required
Example:

"Berlin"

avatar_url
string<uri> | null
required
banner_image_url
string<uri> | null
required

Banner behind the profile header.

background_video_url
string<uri> | null
required
antibot_enabled
boolean
required
Example:

false

direct_button_enabled
boolean
required
Example:

false

direct_button_text
string | null
required
direct_button_url
string<uri> | null
required
widgets
object[]
required
socials
object[]
required
pixels
object[]
required
geo_blocklists
object
required
tease_chat
object | null
required

Null when the chat was never configured, was reset, or your plan does not include it.