# okl.ink

- [Introduction](https://okl-ink.mintlify.app/introduction.md): okl.ink is a clean, modern link-in-bio and link gist platform built for creators, builders, and developers.
- [Quickstart](https://okl-ink.mintlify.app/quickstart.md): Get started with okl.ink in under 2 minutes: create an account, build your first page, configure your theme, and publish.
- [Product Overview](https://okl-ink.mintlify.app/guides/overview.md): Understand the core concepts, data model, and architecture of okl.ink pages.
- [Bento Grid & Canvas Builder](https://okl-ink.mintlify.app/guides/bento-grid.md): How okl.ink uses bento grid geometry, drag-and-drop mechanics, and automatic layout filling.
- [Theming & Design Tokens](https://okl-ink.mintlify.app/guides/theming.md): Explore the procedural theming engine, preset palettes, typography options, and contrast math.
- [Link Types & Widgets](https://okl-ink.mintlify.app/guides/link-types.md): Supported link categories, social media embeds, OpenGraph metadata parsing, and icon styles.
- [Password Protection](https://okl-ink.mintlify.app/guides/passwords-security.md): Learn how to secure private project pages with password gates and manage visitor access.
- [Shortlinks & Analytics](https://okl-ink.mintlify.app/guides/analytics-shortlinks.md): Understand how /r/:id shortlinks work, track outbound click counts, and analyze visitor engagement.
- [Trust & Safety](https://okl-ink.mintlify.app/guides/trust-and-safety.md): How okl.ink prevents abuse, verifies destination safety, and handles community reports.
- [REST API Overview](https://okl-ink.mintlify.app/api-reference/overview.md): Authentication, base URLs, error formats, and scopes for the okl.ink v1 REST API.
- [Create API Token](https://okl-ink.mintlify.app/api-reference/tokens/create.md): Issue a new scoped API token for the currently authenticated user session.
- [List API Tokens](https://okl-ink.mintlify.app/api-reference/tokens/list.md): Retrieve all active, non-revoked API tokens belonging to the authenticated user.
- [Revoke API Token](https://okl-ink.mintlify.app/api-reference/tokens/delete.md): Immediately revoke an API token.
- [Create Page](https://okl-ink.mintlify.app/api-reference/pages/create.md): Create a new project page with metadata, optional theme, and links.
- [List Pages](https://okl-ink.mintlify.app/api-reference/pages/list.md): List all pages created by the authenticated user.
- [Get Page](https://okl-ink.mintlify.app/api-reference/pages/get.md): Fetch full project details including ordered links, theme config, and security status.
- [Update Page](https://okl-ink.mintlify.app/api-reference/pages/update.md): Modify title, description, slug, creator name, or cover image for an existing page.
- [Toggle Publish](https://okl-ink.mintlify.app/api-reference/pages/publish.md): Toggle the published state of an okl.ink page.
- [Get & Set Theme](https://okl-ink.mintlify.app/api-reference/pages/theme.md): Retrieve or update the visual theme configuration for a page.
- [Add Link](https://okl-ink.mintlify.app/api-reference/links/add.md): Append a new link tile to an okl.ink page bento grid.
- [List Page Links](https://okl-ink.mintlify.app/api-reference/links/list.md): Retrieve all links belonging to a project ordered by position.
- [Validate Link URL](https://okl-ink.mintlify.app/api-reference/links/validate.md): Verify that a candidate URL is safe, reachable via HTTP/HTTPS, and compliant with okl.ink safety policies.
- [OG Image Resolver](https://okl-ink.mintlify.app/api-reference/og.md): Server-side utility endpoint to parse OpenGraph image metadata from external URLs.

## OpenAPI Specs

- [openapi](/api-reference/openapi.yaml)