API & agents

Short links and QR — built for humans and AI assistants.

Machine discovery: `GET /v1/capabilities` (OpenAPI 1.6.2).

Paid plans aren't available yet.

Quick start

Create one short link, read `state`, prefer `short_url_ascii` in agents.

1. Call `POST /v1/links` (anon OK within limits) · 2. Send `Idempotency-Key` · 3. If `state` is `active`, use URLs; else poll `status_url`

curl

curl -sS -X POST 'https://xn--s7y.xn--3ds443g/v1/links' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"url":"https://example.com/hello"}'

Prefer short_url_ascii / punycode host for agents.