Authentication #

All management API endpoints require API key authentication. Every request must supply two things: an API key in the request header and a Workspace ID in the request body or query string.

Base URL #

https://api.revolink.link/apiv1/

Getting Your Credentials #

1. Open the Revolink app and go to Profile → Integrations.
2. Click Generate API Key. Copy and save the key — it is shown only once. If you lose it, regenerate a new one (the old key is invalidated immediately).
3. Copy your Workspace ID from the same page.

Sending the API Key #

Pass the key in the X-Api-Key header on every request:

X-Api-Key: rvlnk_your_api_key_here

Sending the Workspace ID #

Include workspaceId on every request:

• POST / PUT / DELETE — in the JSON request body.
• GET — as a query parameter.

# POST example
curl -X POST https://api.revolink.link/apiv1/link/create \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: rvlnk_your_api_key_here" \
  -d '{
    "workspaceId": "your_workspace_id",
    "name": "My link",
    "rules": [
      {
        "id": "rule-1",
        "targetUrl": "https://example.com",
        "isDefault": true
      }
    ]
  }'

Authentication Errors #