Skip to main content

​
API Introduction

The linkutm REST API lets you create and manage short links, domains, tags, folders, and analytics programmatically.

​
Base URL

https://api.linkutm.com/api/v1
All endpoints are relative to this base URL.

​
Authentication

Every request must include an Authorization header. Two auth methods are supported: Generate an API key from Dashboard → Settings → Developer → API Keys. 
Authorization: Bearer lk_live_<your_api_key>
API keys are scoped to a workspace. The x-workspace-id header is not required when using an API key — the workspace is resolved automatically from the key. 
curl https://api.linkutm.com/api/v1/links \
  -H "Authorization: Bearer lk_live_abc123..."

​
JWT Token

Obtained from POST /auth/login. When using a JWT, you must include the workspace you want to operate in: 
Authorization: Bearer <jwt_token>
X-Workspace-Id: <workspace_id>

​
Workspace Header

Auth methodx-workspace-id header
API Key (lk_live_...)Optional — auto-resolved from the key
JWT tokenRequired
You can find your workspace ID in Dashboard → Settings → General.

​
Example Requests

With API key (no workspace header needed): 
curl https://api.linkutm.com/api/v1/links \
  -H "Authorization: Bearer lk_live_abc123..."
With API key and explicit workspace (must match the key’s workspace): 
curl https://api.linkutm.com/api/v1/links \
  -H "Authorization: Bearer lk_live_abc123..." \
  -H "X-Workspace-Id: ws_01hx9ab3..."
With JWT: 
curl https://api.linkutm.com/api/v1/links \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Workspace-Id: ws_01hx9ab3..."