Lnk.Bio

Showing 25 of 33 from the live probe.

• Get Profile

  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 b

• Update Profile Pic

  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.

• List Links

  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.

• Add Link

  Use this to add a link to the profile. IMPORTANT: links are stored but will NOT appear unless the page has a BLOCK_LNKS block. Ensure the block skeleton is built first. ALWAYS attempt to source an image before creating the link: browse the destination URL for the site's og:image, logo, or favicon. Links with images receive 2-3x more clicks than text-only links. Only omit the image if the destination site has no usable image at all. Titles should be clean, plain text (e.g. "Start Learning For Fre

• Edit Link

  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.

• Delete Link

  Permanently delete a link from the user's Lnk.Bio profile. This cannot be undone.

• Sort Links

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

• List Groups

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

• List Pages

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

• Add Page

  Use this to create a new page. New pages are EMPTY. After creating, you must add at least BLOCK_PROFILEPIC (for the profile picture and username to appear) and BLOCK_LNKS (for links to appear) using add_block. Title must be at least 5 characters. Custom URLs require a UNIQUE subscription.

• Edit Page

  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.

• Delete Page

  Permanently delete a page. The main page (PAGE_LNKS) cannot be deleted. This cannot be undone.

• Sort Pages

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

• List Blocks

  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 Block Types

  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.

• Add Block

  Use this to add a structural block to the page layout. Blocks control what is rendered: without BLOCK_PROFILEPIC the profile picture is invisible, without BLOCK_LNKS links are invisible. Build the full block skeleton BEFORE populating content. Call list_blocks first to avoid duplicates. Follow the archetype from list_block_types. WARNING: add_block PREPENDS by default. Calling it multiple times without the "after" parameter produces REVERSE visual order. Always call sort_blocks after adding all

• Delete Block

  Delete a block from a page. The block and its data are permanently removed.

• Sort Blocks

  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.

• List Forms

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

• Search Icons

  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.

• List Icons

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

• Add Icon

  Add an icon to a BLOCK_ICONS block. Each icon type can only appear once per block. Instagram and TikTok usernames are automatically formatted to full URLs.

• Edit Icon

  Update the URL of an existing icon in a BLOCK_ICONS block.

• Delete Icon

  Remove an icon from a BLOCK_ICONS block. The block itself is not deleted, only the specified icon.

• Sort Icons

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