Update Page

Updates an existing Link-in-Bio page. Only the fields you include in the request body are modified. Changes to a published page are reflected immediately on the public URL.

PATCH /v1/bio/pages/{page_id}

bio:write

Parameters

Path parameters

Parameter	Type	Required	Description
page_id	string	Yes	The unique identifier of the page.

Request body

All fields are optional. Only included fields are updated.

Parameter	Type	Description
title	string	Page title displayed at the top of the bio page.
description	string	Short description or tagline.
page_data	object	JSON object containing the page layout, links, theme, and other configuration.

Caution

When updating page_data, the entire object is replaced — not merged. Include all fields you want to keep in the updated page_data.

Request examples

curl

curl -X PATCH https://xqr.co/api/v1/bio/pages/bio_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Acme Inc - Updated",
    "page_data": {
      "theme": "light",
      "avatar_url": "https://cdn.xqr.co/avatars/acme-v2.png",
      "links": [
        { "label": "Website", "url": "https://acme.com" },
        { "label": "Blog", "url": "https://blog.acme.com" },
        { "label": "Twitter", "url": "https://twitter.com/acme" },
        { "label": "GitHub", "url": "https://github.com/acme" }
      ]
    }
  }'

TypeScript

const pageId = "bio_abc123";

const res = await fetch(
  `https://xqr.co/api/v1/bio/pages/${pageId}`,
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      title: "Acme Inc - Updated",
      page_data: {
        theme: "light",
        avatar_url: "https://cdn.xqr.co/avatars/acme-v2.png",
        links: [
          { label: "Website", url: "https://acme.com" },
          { label: "Blog", url: "https://blog.acme.com" },
          { label: "Twitter", url: "https://twitter.com/acme" },
          { label: "GitHub", url: "https://github.com/acme" },
        ],
      },
    }),
  }
);

const { data, meta } = await res.json();

Python

import httpx

page_id = "bio_abc123"

res = httpx.patch(
    f"https://xqr.co/api/v1/bio/pages/{page_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "title": "Acme Inc - Updated",
        "page_data": {
            "theme": "light",
            "avatar_url": "https://cdn.xqr.co/avatars/acme-v2.png",
            "links": [
                {"label": "Website", "url": "https://acme.com"},
                {"label": "Blog", "url": "https://blog.acme.com"},
                {"label": "Twitter", "url": "https://twitter.com/acme"},
                {"label": "GitHub", "url": "https://github.com/acme"},
            ],
        },
    },
)

page = res.json()["data"]

Response

200 OK

{
  "data": {
    "id": "bio_abc123",
    "title": "Acme Inc - Updated",
    "description": "Official links and resources",
    "slug": "acme-inc",
    "page_data": {
      "theme": "light",
      "avatar_url": "https://cdn.xqr.co/avatars/acme-v2.png",
      "links": [
        { "label": "Website", "url": "https://acme.com" },
        { "label": "Blog", "url": "https://blog.acme.com" },
        { "label": "Twitter", "url": "https://twitter.com/acme" },
        { "label": "GitHub", "url": "https://github.com/acme" }
      ]
    },
    "is_published": true,
    "published_at": "2026-03-15T14:00:00Z",
    "view_count": 1247,
    "click_count": 892,
    "html_url": "https://bio.xqr.co/acme-inc",
    "created_at": "2026-03-10T10:00:00Z",
    "updated_at": "2026-03-21T11:30:00Z"
  },
  "meta": {
    "request_id": "req_b1c2d3",
    "rate_limit": {
      "remaining": 46,
      "reset_at": "2026-03-21T12:01:00Z"
    }
  }
}