Lnk.Bio

Update one or more properties of an existing link. Only included fields are updated; omitted fields are left unchanged. Empty strings clear optional fields like image, group_id, and schedule.

edit_link

Update properties of an existing page. Only included fields are updated. The main page (PAGE_LNKS) cannot have its URL or icon changed, and cannot be hidden. An empty url string clears the custom URL.

edit_page

Use this as the FIRST call when creating, building, or improving a profile. Returns username, profile URL, and profile picture. If profile_pic is empty or shows the default avatar, set a real one using update_profile_pic. Then call get_style to check the theme, then call list_block_types to pick a layout archetype matching the user (creator, business, local_business, musician, journalist, personal), then call list_blocks to see the current page structure. Follow the archetype's blocks array to build the page. BLOCK_PROFILEPIC must always be first. Add links via add_link. Call sort_blocks at the end to enforce order.

get_profile

Use this after get_profile to check the current style. If no theme is applied (theme_id is 0 or empty), apply one using list_themes + apply_theme to give the profile a polished, professional look.

get_style

Use this BEFORE adding any blocks. Returns available block types AND example_layouts with proven archetypes (creator, business, local_business, musician, journalist, personal). Pick the archetype closest to the user, then follow its blocks array as the page structure, its icons list, and its link_titles for clean title inspiration. Check the "recommended" and "warning" fields on each type. Never add BLOCK_TITLE, BLOCK_HEADLINE, or BLOCK_BUTTON.

list_block_types

Use this to see the current block structure of a page. Call this before adding blocks to avoid duplicates. Check the _hints field in the response for warnings. Correct block order: BLOCK_PROFILEPIC (first, this is the page header), BLOCK_BIO, BLOCK_ICONS, BLOCK_VIDEO, BLOCK_LNKS. Use sort_blocks to fix order if needed.

list_blocks

List available font families. Optionally filter by name. Use the font_id when setting fonts via set_fonts.

list_fonts

List available forms (id, name, type). Use form IDs when creating a BLOCK_FORM block. Requires UNIQUE subscription.

list_forms

Retrieve all link groups on the user's Lnk.Bio profile. Requires a MINI subscription.

list_groups

List all icons in a BLOCK_ICONS block. Returns each icon's type, URL, visibility, and position.

list_icons

Use this to retrieve all links on the user's Lnk.Bio profile. Check the results for links missing images. For every link without an image, browse its destination URL to find the og:image, logo, or favicon, then call edit_link to attach it.

list_links

List all pages for the authenticated user, including position, visibility status, and remaining page quota.

list_pages

Use this to find a theme for the profile. Every profile should have a theme applied for a professional look. Filter by name or color to match the user's brand. Use the theme_id with apply_theme.

list_themes

Remove the active theme and reset all colors, wallpapers, and effects to their default values.

reset_theme

Use this to find icon type_ids before calling add_icon. Every profile should have social media icons. Common searches: "instagram", "tiktok", "youtube", "twitter", "facebook", "linkedin". IMPORTANT: email, phone, and WhatsApp are also icons (not links). When a user wants to add their email, phone, or WhatsApp, search for them here and add them as icons in a BLOCK_ICONS block, not as links. Minimum 3 characters.

search_icons

Update one or more color properties. Only included fields are updated. Pass an empty string to reset a color to default. Requires UNIQUE subscription.

set_colors

Update one or more font settings. Use list_fonts to find font IDs. Pass an empty string to reset to default. Requires UNIQUE subscription.

set_fonts

Set mobile and/or desktop wallpaper images. Provide a URL to an image (jpg, png, gif, svg). Pass an empty string to remove. Requires UNIQUE subscription.

set_wallpapers

Use this after adding all blocks to enforce the correct visual order. Every block currently in the page must be included. BLOCK_PROFILEPIC MUST be at position 0 (first) so the profile picture and name appear at the top. Recommended order: BLOCK_PROFILEPIC, BLOCK_BIO, BLOCK_ICONS, BLOCK_VIDEO, BLOCK_LNKS.

sort_blocks

Rearrange the order of icons within a BLOCK_ICONS block. All icons currently in the block must be included.

sort_icons

Set the position for multiple links at once. Only the specified links are updated; others keep their current position.

sort_links

Set the order of all pages. Every page must be included in the request.

sort_pages

Use this to upload a profile picture. IMPORTANT: uploading the picture does NOT make it visible. The page must have a BLOCK_PROFILEPIC block for the picture to render. Build the block skeleton first (add_block), then upload the picture. Ask the user for their preferred image, or use their brand logo from their website.

update_profile_pic