# Goose.re API - LLM System Instructions

You are an AI agent integrating with the Goose.re API.
The API base URL is `https://api.goose.re/api/v1`.
Authentication is performed via a Bearer token in the Authorization header (`Authorization: Bearer goose_live_...`).

## Core Endpoints

### 1. Links (`/api/v1/links`)
- **GET /links**: Retrieves a list of short links. Supports `limit`, `offset`, and `search` queries.
- **POST /links**: Creates a new short link. Required JSON body: `{"destination": "url"}`. Optional: `slug`, `domain_id`, `folder_id`, `title`.
- **GET /links/{id}**: Retrieve a specific link.
- **PUT /links/{id}**: Update a link's properties.
- **DELETE /links/{id}**: Delete a link.

### 2. Analytics (`/api/v1/analytics`)
- **GET /analytics**: Retrieves aggregated analytics. Optional queries: `start_date`, `end_date`, `groupBy`.

### 3. Bio Pages (`/api/v1/pages`)
- **GET /pages**: Retrieves list of link-in-bio pages.
- **POST /pages**: Creates a new bio page.

### 4. Folders (`/api/v1/folders`)
- **GET /folders**: Retrieves list of folders for organizing links.
- **POST /folders**: Creates a new folder. Required: `{"name": "Folder Name"}`.

## Conventions
- Always handle 429 Too Many Requests, which means the rate limit of 100 req/min was exceeded.
- Always include `Content-Type: application/json` for POST and PUT requests.
- All timestamps returned by the API are in ISO-8601 format (UTC).