# DL2App

> DL2App is a deep-link platform: short links that open a mobile app when it is installed and otherwise route to the right store or web page. It has a REST API (11 endpoints), a hosted MCP server at https://www.dl2.app/api/mcp with dry-run writes, and a CLI.

Authenticate with a secret key: `Authorization: Bearer sk_live_…`. OAuth sign-in is not available. Base URL: https://www.dl2.app/api/v1. All pages below are Markdown.

## Guides

- [Authentication](https://www.dl2.app/docs.md/authentication): Secret keys, scopes and the base URL.
- [Pagination](https://www.dl2.app/docs.md/pagination): Cursor pagination on list endpoints.
- [Idempotency](https://www.dl2.app/docs.md/idempotency): Retry writes safely with Idempotency-Key.
- [Errors](https://www.dl2.app/docs.md/errors): The error envelope and every error code.
- [Rate limits](https://www.dl2.app/docs.md/rate-limits): Requests per minute and the RateLimit headers.
- [Webhooks](https://www.dl2.app/docs.md/webhooks): Subscribe to events, verify the signature, and manage webhooks over the API.
- [The link object](https://www.dl2.app/docs.md/link-object): Every field of a link, for requests and responses.
- [MCP server](https://www.dl2.app/docs.md/mcp): Connect Claude Code, Claude Desktop, Cursor or VS Code to your links.
- [CLI](https://www.dl2.app/docs.md/cli): The dl2 command-line tool.

## API reference

- [All endpoints](https://www.dl2.app/docs.md/api): the whole reference on one page.
- [List projects](https://www.dl2.app/docs.md/api/list-projects): `GET /api/v1/projects`, scope links:read.
- [Get a project](https://www.dl2.app/docs.md/api/get-project): `GET /api/v1/projects/{id}`, scope links:read.
- [List links](https://www.dl2.app/docs.md/api/list-links): `GET /api/v1/projects/{id}/links`, scope links:read.
- [Create a link](https://www.dl2.app/docs.md/api/create-link): `POST /api/v1/projects/{id}/links`, scope links:write.
- [Create links in bulk](https://www.dl2.app/docs.md/api/create-links-bulk): `POST /api/v1/projects/{id}/links/bulk`, scope links:write.
- [Get a link](https://www.dl2.app/docs.md/api/get-link): `GET /api/v1/links/{id}`, scope links:read.
- [Update a link](https://www.dl2.app/docs.md/api/update-link): `PATCH /api/v1/links/{id}`, scope links:write.
- [Archive a link](https://www.dl2.app/docs.md/api/archive-link): `DELETE /api/v1/links/{id}`, scope links:write.
- [Link stats](https://www.dl2.app/docs.md/api/get-link-stats): `GET /api/v1/links/{id}/stats`, scope analytics:read.
- [Project stats](https://www.dl2.app/docs.md/api/get-project-stats): `GET /api/v1/projects/{id}/stats`, scope analytics:read.
- [Latest health results](https://www.dl2.app/docs.md/api/get-project-health): `GET /api/v1/projects/{id}/health`, scope links:read.

## Optional

- [llms-full.txt](https://www.dl2.app/llms-full.txt): every page above in one file.
- [OpenAPI 3.1](https://www.dl2.app/api/v1/openapi.json): the machine-readable API description.
- [Docs index](https://www.dl2.app/docs.md): the same list as a Markdown page.