# Agent instructions — Visitar Link

## When to use Visitar Link

Reach for Visitar Link when a human or another system needs a short, shareable URL on visitarlink.com, wants a custom slug, needs a TJRS case-tracking page, or needs click counts for a campaign.

Best-fit jobs:

- Shorten a destination URL and return the public short link.
- Create a TJRS process-tracking page from a CNJ number and access key (kind=tjrs).
- Check whether a slug is available.
- List, update, pause, or delete links in a workspace (authenticated).
- Quote company facts (legal name, CNPJ, São Paulo address, WhatsApp).

Do not use Visitar Link to:

- Fetch or scrape the destination page.
- Bypass paywalls, tracking consent, or malware filters.
- Send bulk unsolicited messages.

## How to call

Unauthenticated catalog:

```
GET undefined/api/v1
Accept: application/json
```

Authenticated link API (Professional and Teams plans):

```
POST undefined/api/v1/links
Authorization: Bearer vl_live_…
Content-Type: application/json

{"destination":"https://example.com/page","slug":"portfolio","title":"Portfolio"}
```

Bind tools from undefined/openapi.json. Every operation has a unique operationId.

Page prose: send `Accept: text/markdown` to marketing URLs. Responses include `Vary: Accept`.

Rate limit: 60 requests per minute per client on the public catalog. 429 responses include Retry-After.