API reference/Links

Repoint a short link

Change an owned short link's destination. Existing printed QR codes immediately use the new target.

PATCH/api/v1/links/{token}

Authentication

Send your workspace key as xi-api-key or Authorization: Bearer.

links:writewrite

Parameters

Named placeholders belong in the path. Other arguments use a JSON body.

tokenRequired: string
targetRequired: string

Response

JSON response with status 200.

Requests and errors →

Illustrative arguments

{
  "token": "YOUR_VALUE",
  "target": "YOUR_VALUE"
}

Input schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-zA-Z0-9_-]+$"
    },
    "target": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    }
  },
  "required": [
    "token",
    "target"
  ],
  "additionalProperties": false
}

Response schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "ok"
  ],
  "additionalProperties": false
}