API Reference

Meshalive REST API

Full CRUD API for short links, analytics, and workspace management. Completely free — no paid plan required, no rate limits by tier.

Base URL: https://api.meshalive.com/v1

Authentication

All authenticated endpoints require a Bearer token in the Authorization header. Two token types are supported:

JWT (dashboard sessions)

Authorization: Bearer eyJhbGci...

15-minute expiry. Refresh via POST /v1/auth/refresh.

API token (programmatic)

Authorization: Bearer mshl_••••••••

Long-lived. Create from Settings → API Tokens.

Quick start

Create a short link

curl -X POST https://api.meshalive.com/v1/links \
  -H "Authorization: Bearer mshl_your_api_token" \
  -H "Content-Type: application/json" \
  -H "X-Workspace-ID: your-workspace-uuid" \
  -d '{"destination": "https://example.com/product", "slug": "product"}'

# Response
{
  "id": "018e4c1a-...",
  "short_url": "https://meshalive.com/product",
  "slug": "product",
  "destination": "https://example.com/product",
  "clicks": 0,
  "created_at": "2026-05-20T10:00:00Z"
}

Endpoints

Method	Path	Description
POST	/v1/auth/register	Create a new user account and default workspace
POST	/v1/auth/login	Authenticate and receive a JWT access token
POST	/v1/auth/refresh	Rotate refresh token and receive a new JWT
POST	/v1/auth/logout	Invalidate the current session
GET	/v1/links	List all short links in the workspace
POST	/v1/links	Create a new short link
PATCH	/v1/links/:id	Update a short link (slug, destination, tags, expiry)
DELETE	/v1/links/:id	Archive a short link
GET	/v1/links/:id/analytics	Get click analytics for a specific link
GET	/v1/workspace	Get current workspace details
GET	/v1/workspace/members	List workspace members and roles

Rate limits

All users

Unlimited requests

Auth endpoints

10 req / min (anti-abuse)

Redirect

No limit

Ready to integrate?

Get your API token free — no paid plan required.

Get started →