Get & Set Theme

Retrieve or update the visual theme configuration for a page.

PUT /api/v1/pages/{id}/theme

cURL

curl -X PUT https://okl.ink/api/v1/pages/cly1019283749/theme \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "preset": "midnight",
    "accent": "#a855f7",
    "typography": "geist",
    "radius": "soft",
    "density": "airy"
  }'

200 OK

{
  "success": true
}

Page Theme

Retrieve (GET) or set (PUT) the complete styling and layout token configuration for an okl.ink page.

---

1. Get Theme (GET /api/v1/pages/{id}/theme)

Requires pages:read scope.

Response

Returns the stored ThemeConfig JSON object or null.

---

2. Set Theme (PUT /api/v1/pages/{id}/theme)

Requires pages:write scope.

Request Body

preset · string · required

One of: oklink, midnight, paper, vivid, lofi.

background · string | null

Optional custom hex background (e.g. #111827).

accent · string | null

Optional custom hex accent color (e.g. #10b981).

linkStyle · string · default: "rounded"

One of: rounded, pill, outline, filled, minimal.

typography · string · default: "modern"

One of: modern, editorial, mono, geist.

radius · string · default: "rounded"

One of: sharp, rounded, soft, pill.

density · string · default: "comfortable"

One of: compact, comfortable, airy.

iconStyle · string · default: "duotone"

One of: duotone, filled, colored.

layoutMode · string · default: "grid"

grid or list.

showByline · boolean · default: "true"

Whether to render the creator avatar and byline in header.

Response

success · boolean

Returns true when the theme update succeeds.

cURL

curl -X PUT https://okl.ink/api/v1/pages/cly1019283749/theme \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "preset": "midnight",
    "accent": "#a855f7",
    "typography": "geist",
    "radius": "soft",
    "density": "airy"
  }'

200 OK

{
  "success": true
}