Unpublish Page

Unpublishes a Link-in-Bio page, removing it from public access. The page’s public URL will return a 404 until it is published again. The page data and analytics are preserved. If the page is already unpublished, this endpoint is a no-op.

POST /v1/bio/pages/{page_id}/unpublish

bio:write

Parameters

Path parameters

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

Tip

Unpublishing preserves all page data and analytics. Use this instead of delete when you want to temporarily hide a page.

Request examples

curl

curl -X POST https://xqr.co/api/v1/bio/pages/bio_abc123/unpublish \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const pageId = "bio_abc123";

const res = await fetch(
  `https://xqr.co/api/v1/bio/pages/${pageId}/unpublish`,
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);

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

Python

import httpx

page_id = "bio_abc123"

res = httpx.post(
    f"https://xqr.co/api/v1/bio/pages/{page_id}/unpublish",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

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

Response

200 OK

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