AuvaDocs
Sign in

Short Links

The core feature of Auva Go. Shorten any URL into a clean, trackable link.

Create a Link

text
POST https://go.auva.dev/api/links
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "url": "https://example.com/path",
  "slug": "my-custom-slug",    // Optional
  "title": "My Link Title"     // Optional
}

Parameters

FieldTypeRequiredDescription
urlstringYesThe destination URL (must be a valid URL)
slugstringNoCustom slug. If omitted, a random one is generated
titlestringNoA human-readable label for the link

List All Links

text
GET https://go.auva.dev/api/links
Authorization: Bearer YOUR_ACCESS_TOKEN

Response:

text
{
  "links": [
    {
      "id": "lnk_abc123",
      "shortUrl": "https://go.auva.dev/my-link",
      "originalUrl": "https://example.com/path",
      "slug": "my-link",
      "title": "My Link",
      "clicks": 142,
      "createdAt": "2024-03-15T10:30:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 50
}

Update a Link

text
PATCH https://go.auva.dev/api/links/{id}
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "url": "https://new-destination.com",
  "title": "Updated Title"
}

You can change the destination URL at any time. The short link URL stays the same: all existing QR codes and shared links continue to work.

Delete a Link

text
DELETE https://go.auva.dev/api/links/{id}
Authorization: Bearer YOUR_ACCESS_TOKEN

Deleted links return a 404 when visited. This action cannot be undone.

Slug Rules