# getlinks.si

> getlinks.si is a URL shortener that pays creators per completed view. Its HTTP API lets developers and AI agents create and manage short links.

Authenticate with a workspace API key: send the header `Authorization: Bearer gl_…`. Keys are created by workspace owners/admins in Dashboard → Developers and are bound to one workspace id (`wid` in paths).
Rate limit: 120 requests per 60 seconds per key (429 RATE_LIMITED when exceeded).
Errors are JSON with an `error` object holding `code`, `message`, `requestId` and `retryable`. Branch on `code`.

## Endpoints

- GET https://api-staging.getlinks.si/v1/workspaces/{wid}/links: list links (page, pageSize, q)
- POST https://api-staging.getlinks.si/v1/workspaces/{wid}/links: create a short link (destination required)
- GET https://api-staging.getlinks.si/v1/workspaces/{wid}/links/{id}: get a link
- PATCH https://api-staging.getlinks.si/v1/workspaces/{wid}/links/{id}: update a link
- DELETE https://api-staging.getlinks.si/v1/workspaces/{wid}/links/{id}: delete a link
- GET https://api-staging.getlinks.si/v1/workspaces/{wid}/links/{id}/stats: daily stats for a link (from, to)

## Docs

- [OpenAPI 3.1](https://api-staging.getlinks.si/v1/openapi.json): machine-readable spec of the endpoints above
- [Developers](/developers): human-readable guide with examples