# API reference

Every endpoint a Clikso API key can call. Base URL `https://app.clik.so/api`. Send `Authorization: Bearer <your key>` on every request.

## Links

Create, read, update and delete short links, one at a time or up to 100 at once.

* [List links](https://clik.so/docs/api/links/list-links) — `GET /links`
* [Create a link](https://clik.so/docs/api/links/create-link) — `POST /links`
* [Get a link](https://clik.so/docs/api/links/get-link) — `GET /links/{id}`
* [Update a link](https://clik.so/docs/api/links/update-link) — `PUT /links/{id}`
* [Delete a link](https://clik.so/docs/api/links/delete-link) — `DELETE /links/{id}`
* [Update many links](https://clik.so/docs/api/links/bulk-update-links) — `PATCH /links/bulk`
* [Delete many links](https://clik.so/docs/api/links/bulk-delete-links) — `DELETE /links/bulk`
* [Check a slug](https://clik.so/docs/api/links/check-slug) — `GET /links/slug-check`
* [Generate a random slug](https://clik.so/docs/api/links/generate-slug) — `GET /links/generate-slug`
* [Suggest slugs with AI](https://clik.so/docs/api/links/suggest-slugs) — `POST /links/ai-slug`
* [Get AI slug usage](https://clik.so/docs/api/links/get-ai-slug-usage) — `POST /links/ai-slug/consume`
* [Preview a page's social card](https://clik.so/docs/api/links/preview-link) — `POST /links/og-preview`

## Folders

Group links into folders. Each link sits in at most one folder.

* [List folders](https://clik.so/docs/api/folders/list-folders) — `GET /folders`
* [Create a folder](https://clik.so/docs/api/folders/create-folder) — `POST /folders`
* [Get a folder](https://clik.so/docs/api/folders/get-folder) — `GET /folders/{id}`
* [Rename a folder](https://clik.so/docs/api/folders/update-folder) — `PUT /folders/{id}`
* [Delete a folder](https://clik.so/docs/api/folders/delete-folder) — `DELETE /folders/{id}`

## Tags

Label links with coloured tags. A link can carry any number of tags.

* [List tags](https://clik.so/docs/api/tags/list-tags) — `GET /tags`
* [Create a tag](https://clik.so/docs/api/tags/create-tag) — `POST /tags`
* [Get a tag](https://clik.so/docs/api/tags/get-tag) — `GET /tags/{id}`
* [Update a tag](https://clik.so/docs/api/tags/update-tag) — `PUT /tags/{id}`
* [Delete a tag](https://clik.so/docs/api/tags/delete-tag) — `DELETE /tags/{id}`

## Domains

Read the domains your links can use, including your verified custom domains.

* [List custom domains](https://clik.so/docs/api/domains/list-domains) — `GET /domains`
* [Get a custom domain](https://clik.so/docs/api/domains/get-domain) — `GET /domains/{id}`
* [List free Clikso domains](https://clik.so/docs/api/domains/list-system-domains) — `GET /system-domains`

## Workspace

Read your workspace's plan, limits, usage and domain preferences.

* [Get workspace details](https://clik.so/docs/api/workspace/get-bootstrap) — `GET /workspace/bootstrap`
* [Get usage](https://clik.so/docs/api/workspace/get-usage) — `GET /workspace/usage`
* [Get domain preferences](https://clik.so/docs/api/workspace/get-domain-prefs) — `GET /workspace/domain-prefs`

## Analytics

Read click counts, breakdowns, time series and raw clicks for your links.

* [Get click summary](https://clik.so/docs/api/analytics/get-analytics-summary) — `POST /analytics/summary`
* [Get clicks over time](https://clik.so/docs/api/analytics/get-analytics-timeseries) — `POST /analytics/timeseries`
* [List raw clicks](https://clik.so/docs/api/analytics/list-clicks) — `POST /analytics/filter`

---

Source: https://clik.so/docs/api