# Lnk.Bio

## Docs
- Getting Started [Introduction](https://api.lnk.bio/doc-498634.md): 
- Getting Started [Endpoints](https://api.lnk.bio/doc-498656.md): 
- Getting Started [Authorization](https://api.lnk.bio/doc-498638.md): 
- Getting Started > Private Apps [Introduction](https://api.lnk.bio/doc-498648.md): 
- Getting Started > Private Apps [Create a Private App](https://api.lnk.bio/doc-498645.md): 
- Getting Started > Private Apps [Generate an Access Token](https://api.lnk.bio/doc-498652.md): 
- Getting Started > Public Apps [Introduction](https://api.lnk.bio/doc-498662.md): 
- Getting Started > Public Apps [Create a Public App](https://api.lnk.bio/doc-498663.md): 
- Getting Started > Public Apps [Generate an Access Token](https://api.lnk.bio/doc-498664.md): 

## API Docs
- API Methods > Me [Retrieve basic profile info](https://api.lnk.bio/api-6746006.md): Returns basic information about the authenticated user.
- API Methods > Me [Update profile picture](https://api.lnk.bio/api-32678505.md): Set or remove the profile picture. Pass an image URL to set a new profile picture, or an empty string to remove the current one.
- API Methods > Lnks [Retrieve list of current Lnks](https://api.lnk.bio/api-6746007.md): Returns an array of Lnks in the authenticated user's account.
- API Methods > Lnks [Create a new Lnk](https://api.lnk.bio/api-6746008.md): Publish a new Lnk on your public Lnk.Bio profile. The Lnk is immediately posted and will appear on top of any existing Lnk.
- API Methods > Lnks [Delete an existing Lnk](https://api.lnk.bio/api-6746009.md): Delete an existing Lnk from your public Lnk.Bio profile. The Lnk is immediately deleted and cannot be recovered.
- API Methods > Lnks [Edit an existing Lnk](https://api.lnk.bio/api-32678506.md): Update one or more properties of an existing Lnk. Only the fields included in the request are updated; omitted fields are left unchanged. To clear a field, pass an empty string as its value.
- API Methods > Lnks [Bulk reorder Lnks](https://api.lnk.bio/api-32678507.md): Set the position for multiple Lnks at once. Each form field key is a link_id and its value is the desired position (integer). Only the specified Lnks are updated; others keep their current position. Duplicate position values are allowed.
- API Methods > Groups [Retrieve list of Lnk Groups](https://api.lnk.bio/api-6746010.md): Returns the groups in the authenticated user's account. Requires a MINI subscription.
- API Methods > Style [Get current style](https://api.lnk.bio/api-32678508.md): Returns the authenticated user's current style settings including colors, fonts, wallpapers, and active theme.
- API Methods > Style [Set profile colors](https://api.lnk.bio/api-32678509.md): Update one or more color properties. Only the fields included in the request are updated; omitted fields are left unchanged. Pass an empty string to reset a color to its default value. Requires a UNIQUE subscription.
- API Methods > Style [Set profile fonts](https://api.lnk.bio/api-32678510.md): Update one or more font settings. Pass the font_id (retrieve available fonts via /fonts). Pass an empty string to reset to default. Requires a UNIQUE subscription.
- API Methods > Style [Set profile wallpapers](https://api.lnk.bio/api-32678511.md): Set mobile and/or desktop wallpaper images. Provide a URL to an image (jpg, png, gif, svg). The image is downloaded, validated, processed, and uploaded to CDN. Pass an empty string to remove a wallpaper. Requires a UNIQUE subscription.
- API Methods > Style [Apply a free theme](https://api.lnk.bio/api-32678512.md): Apply a free theme to your profile. The theme sets colors, wallpapers, and effects. Retrieve available themes via /themes. Only free themes can be applied via API.
- API Methods > Style [Reset theme to defaults](https://api.lnk.bio/api-32678513.md): Removes the active theme and resets all colors, wallpapers, and effects to their default values.
- API Methods > Style [List available fonts](https://api.lnk.bio/api-32678514.md): Returns a list of available font families. Optionally filter by name.
- API Methods > Style [List available free themes](https://api.lnk.bio/api-32678515.md): Returns a list of available free themes. Optionally filter by name or color.
- API Methods > Pages [List all pages](https://api.lnk.bio/api-33100550.md): Returns all pages for the authenticated user, including their position and visibility status. Also returns the remaining page quota based on the current subscription plan.
- API Methods > Pages [Create a new page](https://api.lnk.bio/api-33100551.md): Create a new empty page. The title must be at least 5 characters. Custom URLs require a UNIQUE subscription. Page creation is limited by the user's subscription plan (FREE: 3, MINI: 5, UNIQUE: 10).
- API Methods > Pages [Edit an existing page](https://api.lnk.bio/api-33100552.md): Update properties of an existing page. Only included fields are updated. Custom URLs require a UNIQUE subscription. The main page (PAGE_LNKS) cannot have its URL or icon changed, and cannot be hidden.
- API Methods > Pages [Reorder pages](https://api.lnk.bio/api-33100558.md): Set the order of all pages. Every page must be included in the request, or an error is returned.
- API Methods > Pages [Delete a page](https://api.lnk.bio/api-33104179.md): Permanently deletes a page and all its blocks. The main page (PAGE_LNKS) cannot be deleted. This action cannot be undone.
- API Methods > Blocks > Icons [Add an icon to a BLOCK_ICONS block](https://api.lnk.bio/api-33100561.md): Add a new icon to an existing BLOCK_ICONS block. The block must have been created via /page/block/add with type BLOCK_ICONS. Each icon type can only appear once per block. Instagram and TikTok usernames are automatically formatted to full URLs.
- API Methods > Blocks > Icons [Edit an icon in a BLOCK_ICONS block](https://api.lnk.bio/api-33100562.md): Update the URL of an existing icon in a BLOCK_ICONS block. Instagram and TikTok usernames are automatically formatted to full URLs.
- API Methods > Blocks > Icons [Search available icons](https://api.lnk.bio/api-33100560.md): Search icons by name. Returns matching icons from the full icon library. Use the returned type_id when adding icons to a BLOCK_ICONS block via /page/block/icon. The search parameter is required and must be at least 3 characters.
- API Methods > Blocks > Icons [Delete an icon from a BLOCK_ICONS block](https://api.lnk.bio/api-33100563.md): Remove an icon from a BLOCK_ICONS block. The block itself is not deleted, only the specified icon within it.
- API Methods > Blocks > Icons [Sort icons within a BLOCK_ICONS block](https://api.lnk.bio/api-33100564.md): Rearrange the order of icons within a BLOCK_ICONS block. All icons currently in the block must be included in the array.
- API Methods > Blocks > Icons [List icons in an Icons block](https://api.lnk.bio/api-33104180.md): Returns all icons in a BLOCK_ICONS block. The block must belong to the authenticated user and must be of type BLOCK_ICONS.
- API Methods > Blocks > Forms [List available forms](https://api.lnk.bio/api-33100559.md): Returns the user's forms (id, name, type). Use these form IDs when creating a BLOCK_FORM block via /page/block/add. Requires a UNIQUE subscription.
- API Methods > Blocks [List blocks in a page](https://api.lnk.bio/api-33100553.md): Returns all blocks in a page, ordered by their position. If page_id is omitted, returns blocks from the first (main) page.
- API Methods > Blocks [List supported block types](https://api.lnk.bio/api-33100554.md): Returns all block types that can be created via /page/block/add, along with their required data fields and example payloads. Use this to discover available block types and build the correct data parameter.
- API Methods > Blocks [Add a block to a page](https://api.lnk.bio/api-33100555.md): Create a new block in a page. Supported block types for this endpoint: BLOCK_TITLE, BLOCK_HEADLINE, BLOCK_BIO, BLOCK_BUTTON, BLOCK_SEPARATOR, BLOCK_SPACER, BLOCK_IMAGE, BLOCK_LNKS, BLOCK_FORM, BLOCK_COUNTDOWN, BLOCK_VIDEO, BLOCK_ICONS. Some blocks require higher subscription plans. BLOCK_ICONS is created empty; use /page/block/icon to add icons to it.
- API Methods > Blocks [Delete a block from a page](https://api.lnk.bio/api-33100556.md): Delete a block from a page. The block and its data are permanently removed. To replace a block, delete it and re-add with /page/block/add using the 'after' parameter to control position.
- API Methods > Blocks [Reorder blocks in a page](https://api.lnk.bio/api-33100557.md): Set the order of all blocks in a page. Every block currently in the page must be included in the request, or an error is returned.

## Schemas
- [Lnk](https://api.lnk.bio/schema-14064332.md): 
- [SuccessResponse](https://api.lnk.bio/schema-14064333.md): 
- [PageSummary](https://api.lnk.bio/schema-14175000.md): 
- [StyleData](https://api.lnk.bio/schema-14064334.md): 
- [BlockSummary](https://api.lnk.bio/schema-14175001.md): 
- [Font](https://api.lnk.bio/schema-14064335.md): 
- [FormSummary](https://api.lnk.bio/schema-14175002.md): 
- [ThemeSummary](https://api.lnk.bio/schema-14064336.md): 
- [BlockType](https://api.lnk.bio/schema-14175003.md): 
- [IconSummary](https://api.lnk.bio/schema-14175004.md):