Upsert shortcut

curl --request PUT \
  --url https://api.uselora.com/v1/shortcuts/{handle} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "https://google.com",
  "title": "<string>",
  "description": "<string>",
  "masked": false,
  "password": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "dynamicRouting": [
    {
      "conditions": [
        {
          "attribute": "country",
          "values": [
            "DE",
            "AT",
            "CH"
          ]
        }
      ],
      "destination": "https://apps.apple.com/de/app/id123456789"
    }
  ],
  "folderId": "a1b2c3d4"
}
'

import requests

url = "https://api.uselora.com/v1/shortcuts/{handle}"

payload = {
    "destination": "https://google.com",
    "title": "<string>",
    "description": "<string>",
    "masked": False,
    "password": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "dynamicRouting": [
        {
            "conditions": [
                {
                    "attribute": "country",
                    "values": ["DE", "AT", "CH"]
                }
            ],
            "destination": "https://apps.apple.com/de/app/id123456789"
        }
    ],
    "folderId": "a1b2c3d4"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    destination: 'https://google.com',
    title: '<string>',
    description: '<string>',
    masked: false,
    password: '<string>',
    expiresAt: '2023-11-07T05:31:56Z',
    dynamicRouting: [
      {
        conditions: [{attribute: 'country', values: ['DE', 'AT', 'CH']}],
        destination: 'https://apps.apple.com/de/app/id123456789'
      }
    ],
    folderId: 'a1b2c3d4'
  })
};

fetch('https://api.uselora.com/v1/shortcuts/{handle}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.uselora.com/v1/shortcuts/{handle}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'destination' => 'https://google.com',
    'title' => '<string>',
    'description' => '<string>',
    'masked' => false,
    'password' => '<string>',
    'expiresAt' => '2023-11-07T05:31:56Z',
    'dynamicRouting' => [
        [
                'conditions' => [
                                [
                                                                'attribute' => 'country',
                                                                'values' => [
                                                                                                                                'DE',
                                                                                                                                'AT',
                                                                                                                                'CH'
                                                                ]
                                ]
                ],
                'destination' => 'https://apps.apple.com/de/app/id123456789'
        ]
    ],
    'folderId' => 'a1b2c3d4'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.uselora.com/v1/shortcuts/{handle}"

	payload := strings.NewReader("{\n  \"destination\": \"https://google.com\",\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"masked\": false,\n  \"password\": \"<string>\",\n  \"expiresAt\": \"2023-11-07T05:31:56Z\",\n  \"dynamicRouting\": [\n    {\n      \"conditions\": [\n        {\n          \"attribute\": \"country\",\n          \"values\": [\n            \"DE\",\n            \"AT\",\n            \"CH\"\n          ]\n        }\n      ],\n      \"destination\": \"https://apps.apple.com/de/app/id123456789\"\n    }\n  ],\n  \"folderId\": \"a1b2c3d4\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.uselora.com/v1/shortcuts/{handle}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"destination\": \"https://google.com\",\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"masked\": false,\n  \"password\": \"<string>\",\n  \"expiresAt\": \"2023-11-07T05:31:56Z\",\n  \"dynamicRouting\": [\n    {\n      \"conditions\": [\n        {\n          \"attribute\": \"country\",\n          \"values\": [\n            \"DE\",\n            \"AT\",\n            \"CH\"\n          ]\n        }\n      ],\n      \"destination\": \"https://apps.apple.com/de/app/id123456789\"\n    }\n  ],\n  \"folderId\": \"a1b2c3d4\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.uselora.com/v1/shortcuts/{handle}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"destination\": \"https://google.com\",\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"masked\": false,\n  \"password\": \"<string>\",\n  \"expiresAt\": \"2023-11-07T05:31:56Z\",\n  \"dynamicRouting\": [\n    {\n      \"conditions\": [\n        {\n          \"attribute\": \"country\",\n          \"values\": [\n            \"DE\",\n            \"AT\",\n            \"CH\"\n          ]\n        }\n      ],\n      \"destination\": \"https://apps.apple.com/de/app/id123456789\"\n    }\n  ],\n  \"folderId\": \"a1b2c3d4\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "url": "https://app.uselora.com/acme/short/handbook",
  "destination": "<string>",
  "title": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "image": "<string>",
  "video": "<string>",
  "visibility": "PRIVATE",
  "archived": true,
  "masked": true,
  "passwordProtected": true,
  "expiresAt": "<string>",
  "dynamicRouting": [
    {
      "conditions": [
        {
          "attribute": "country",
          "operator": "is",
          "values": [
            "DE",
            "AT",
            "CH"
          ]
        }
      ],
      "destination": "https://apps.apple.com/de/app/id123456789"
    }
  ],
  "placeholders": [
    {
      "name": "<string>",
      "default": "<string>"
    }
  ],
  "folderId": "a1b2c3d4",
  "tagIds": [
    "a1b2c3d4"
  ],
  "aliases": [
    "urlaub",
    "ferien"
  ],
  "externalId": "<string>",
  "tenantId": "<string>",
  "comments": "<string>",
  "workspaceId": "<string>",
  "userId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "metadataSync": {
    "description": "auto",
    "title": "auto"
  },
  "previewUrl": "<string>",
  "previewDarkUrl": "<string>",
  "additionalFolderIds": [
    "a1b2c3d4"
  ],
  "iconSettings": {
    "background": {
      "color": "<string>",
      "type": "color"
    },
    "glyph": {
      "ref": "<string>",
      "source": "favicon",
      "variant": "color"
    }
  },
  "previewSettings": {
    "assetId": "<string>",
    "blobHost": "<string>",
    "capturedAt": "2023-11-07T05:31:56Z",
    "capturedFor": "<string>",
    "format": "jpeg",
    "hasDark": true,
    "height": 123,
    "source": "screenshot",
    "width": 123
  },
  "qrSettings": {
    "dotColor": "<string>",
    "dotStyle": "square",
    "frame": "none",
    "hideLogo": true,
    "markerBorder": "square",
    "markerCenter": "square",
    "markerColor": "<string>"
  }
}

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "url": "https://app.uselora.com/acme/short/handbook",
  "destination": "<string>",
  "title": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "image": "<string>",
  "video": "<string>",
  "visibility": "PRIVATE",
  "archived": true,
  "masked": true,
  "passwordProtected": true,
  "expiresAt": "<string>",
  "dynamicRouting": [
    {
      "conditions": [
        {
          "attribute": "country",
          "operator": "is",
          "values": [
            "DE",
            "AT",
            "CH"
          ]
        }
      ],
      "destination": "https://apps.apple.com/de/app/id123456789"
    }
  ],
  "placeholders": [
    {
      "name": "<string>",
      "default": "<string>"
    }
  ],
  "folderId": "a1b2c3d4",
  "tagIds": [
    "a1b2c3d4"
  ],
  "aliases": [
    "urlaub",
    "ferien"
  ],
  "externalId": "<string>",
  "tenantId": "<string>",
  "comments": "<string>",
  "workspaceId": "<string>",
  "userId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "metadataSync": {
    "description": "auto",
    "title": "auto"
  },
  "previewUrl": "<string>",
  "previewDarkUrl": "<string>",
  "additionalFolderIds": [
    "a1b2c3d4"
  ],
  "iconSettings": {
    "background": {
      "color": "<string>",
      "type": "color"
    },
    "glyph": {
      "ref": "<string>",
      "source": "favicon",
      "variant": "color"
    }
  },
  "previewSettings": {
    "assetId": "<string>",
    "blobHost": "<string>",
    "capturedAt": "2023-11-07T05:31:56Z",
    "capturedFor": "<string>",
    "format": "jpeg",
    "hasDark": true,
    "height": 123,
    "source": "screenshot",
    "width": 123
  },
  "qrSettings": {
    "dotColor": "<string>",
    "dotStyle": "square",
    "frame": "none",
    "hideLogo": true,
    "markerBorder": "square",
    "markerCenter": "square",
    "markerColor": "<string>"
  }
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "fieldErrors": {},
  "traceId": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "code": "plan_requires_upgrade",
  "requestId": "<string>",
  "traceId": "<string>",
  "current_plan": "<string>",
  "required_capability": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>",
  "required_scope": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "code": "payload_too_large",
  "requestId": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "code": "internal_error",
  "requestId": "<string>",
  "traceId": "<string>"
}

Shortcuts

Upsert shortcut

Creates a shortcut at the given slug, or updates the existing one. Returns 201 when a new shortcut is created and 200 when an existing one is updated. The handle is taken verbatim as the slug — for symmetry with GET/PATCH/DELETE the segment is named {handle}, but PUT does not resolve UUID-shaped handles to a row’s ID. One guardrail: a UUID-shaped handle that collides with an existing shortcut’s id returns 400 validation_error (use PATCH /v1/shortcuts/{handle} to update by ID); UUID-shaped slugs that don’t collide are accepted as slugs.

PUT

shortcuts

{handle}

Upsert shortcut

curl --request PUT \
  --url https://api.uselora.com/v1/shortcuts/{handle} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destination": "https://google.com",
  "title": "<string>",
  "description": "<string>",
  "masked": false,
  "password": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "dynamicRouting": [
    {
      "conditions": [
        {
          "attribute": "country",
          "values": [
            "DE",
            "AT",
            "CH"
          ]
        }
      ],
      "destination": "https://apps.apple.com/de/app/id123456789"
    }
  ],
  "folderId": "a1b2c3d4"
}
'

import requests

url = "https://api.uselora.com/v1/shortcuts/{handle}"

payload = {
    "destination": "https://google.com",
    "title": "<string>",
    "description": "<string>",
    "masked": False,
    "password": "<string>",
    "expiresAt": "2023-11-07T05:31:56Z",
    "dynamicRouting": [
        {
            "conditions": [
                {
                    "attribute": "country",
                    "values": ["DE", "AT", "CH"]
                }
            ],
            "destination": "https://apps.apple.com/de/app/id123456789"
        }
    ],
    "folderId": "a1b2c3d4"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    destination: 'https://google.com',
    title: '<string>',
    description: '<string>',
    masked: false,
    password: '<string>',
    expiresAt: '2023-11-07T05:31:56Z',
    dynamicRouting: [
      {
        conditions: [{attribute: 'country', values: ['DE', 'AT', 'CH']}],
        destination: 'https://apps.apple.com/de/app/id123456789'
      }
    ],
    folderId: 'a1b2c3d4'
  })
};

fetch('https://api.uselora.com/v1/shortcuts/{handle}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.uselora.com/v1/shortcuts/{handle}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'destination' => 'https://google.com',
    'title' => '<string>',
    'description' => '<string>',
    'masked' => false,
    'password' => '<string>',
    'expiresAt' => '2023-11-07T05:31:56Z',
    'dynamicRouting' => [
        [
                'conditions' => [
                                [
                                                                'attribute' => 'country',
                                                                'values' => [
                                                                                                                                'DE',
                                                                                                                                'AT',
                                                                                                                                'CH'
                                                                ]
                                ]
                ],
                'destination' => 'https://apps.apple.com/de/app/id123456789'
        ]
    ],
    'folderId' => 'a1b2c3d4'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.uselora.com/v1/shortcuts/{handle}"

	payload := strings.NewReader("{\n  \"destination\": \"https://google.com\",\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"masked\": false,\n  \"password\": \"<string>\",\n  \"expiresAt\": \"2023-11-07T05:31:56Z\",\n  \"dynamicRouting\": [\n    {\n      \"conditions\": [\n        {\n          \"attribute\": \"country\",\n          \"values\": [\n            \"DE\",\n            \"AT\",\n            \"CH\"\n          ]\n        }\n      ],\n      \"destination\": \"https://apps.apple.com/de/app/id123456789\"\n    }\n  ],\n  \"folderId\": \"a1b2c3d4\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.uselora.com/v1/shortcuts/{handle}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"destination\": \"https://google.com\",\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"masked\": false,\n  \"password\": \"<string>\",\n  \"expiresAt\": \"2023-11-07T05:31:56Z\",\n  \"dynamicRouting\": [\n    {\n      \"conditions\": [\n        {\n          \"attribute\": \"country\",\n          \"values\": [\n            \"DE\",\n            \"AT\",\n            \"CH\"\n          ]\n        }\n      ],\n      \"destination\": \"https://apps.apple.com/de/app/id123456789\"\n    }\n  ],\n  \"folderId\": \"a1b2c3d4\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.uselora.com/v1/shortcuts/{handle}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"destination\": \"https://google.com\",\n  \"title\": \"<string>\",\n  \"description\": \"<string>\",\n  \"masked\": false,\n  \"password\": \"<string>\",\n  \"expiresAt\": \"2023-11-07T05:31:56Z\",\n  \"dynamicRouting\": [\n    {\n      \"conditions\": [\n        {\n          \"attribute\": \"country\",\n          \"values\": [\n            \"DE\",\n            \"AT\",\n            \"CH\"\n          ]\n        }\n      ],\n      \"destination\": \"https://apps.apple.com/de/app/id123456789\"\n    }\n  ],\n  \"folderId\": \"a1b2c3d4\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "url": "https://app.uselora.com/acme/short/handbook",
  "destination": "<string>",
  "title": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "image": "<string>",
  "video": "<string>",
  "visibility": "PRIVATE",
  "archived": true,
  "masked": true,
  "passwordProtected": true,
  "expiresAt": "<string>",
  "dynamicRouting": [
    {
      "conditions": [
        {
          "attribute": "country",
          "operator": "is",
          "values": [
            "DE",
            "AT",
            "CH"
          ]
        }
      ],
      "destination": "https://apps.apple.com/de/app/id123456789"
    }
  ],
  "placeholders": [
    {
      "name": "<string>",
      "default": "<string>"
    }
  ],
  "folderId": "a1b2c3d4",
  "tagIds": [
    "a1b2c3d4"
  ],
  "aliases": [
    "urlaub",
    "ferien"
  ],
  "externalId": "<string>",
  "tenantId": "<string>",
  "comments": "<string>",
  "workspaceId": "<string>",
  "userId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "metadataSync": {
    "description": "auto",
    "title": "auto"
  },
  "previewUrl": "<string>",
  "previewDarkUrl": "<string>",
  "additionalFolderIds": [
    "a1b2c3d4"
  ],
  "iconSettings": {
    "background": {
      "color": "<string>",
      "type": "color"
    },
    "glyph": {
      "ref": "<string>",
      "source": "favicon",
      "variant": "color"
    }
  },
  "previewSettings": {
    "assetId": "<string>",
    "blobHost": "<string>",
    "capturedAt": "2023-11-07T05:31:56Z",
    "capturedFor": "<string>",
    "format": "jpeg",
    "hasDark": true,
    "height": 123,
    "source": "screenshot",
    "width": 123
  },
  "qrSettings": {
    "dotColor": "<string>",
    "dotStyle": "square",
    "frame": "none",
    "hideLogo": true,
    "markerBorder": "square",
    "markerCenter": "square",
    "markerColor": "<string>"
  }
}

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slug": "<string>",
  "url": "https://app.uselora.com/acme/short/handbook",
  "destination": "<string>",
  "title": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "image": "<string>",
  "video": "<string>",
  "visibility": "PRIVATE",
  "archived": true,
  "masked": true,
  "passwordProtected": true,
  "expiresAt": "<string>",
  "dynamicRouting": [
    {
      "conditions": [
        {
          "attribute": "country",
          "operator": "is",
          "values": [
            "DE",
            "AT",
            "CH"
          ]
        }
      ],
      "destination": "https://apps.apple.com/de/app/id123456789"
    }
  ],
  "placeholders": [
    {
      "name": "<string>",
      "default": "<string>"
    }
  ],
  "folderId": "a1b2c3d4",
  "tagIds": [
    "a1b2c3d4"
  ],
  "aliases": [
    "urlaub",
    "ferien"
  ],
  "externalId": "<string>",
  "tenantId": "<string>",
  "comments": "<string>",
  "workspaceId": "<string>",
  "userId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "metadataSync": {
    "description": "auto",
    "title": "auto"
  },
  "previewUrl": "<string>",
  "previewDarkUrl": "<string>",
  "additionalFolderIds": [
    "a1b2c3d4"
  ],
  "iconSettings": {
    "background": {
      "color": "<string>",
      "type": "color"
    },
    "glyph": {
      "ref": "<string>",
      "source": "favicon",
      "variant": "color"
    }
  },
  "previewSettings": {
    "assetId": "<string>",
    "blobHost": "<string>",
    "capturedAt": "2023-11-07T05:31:56Z",
    "capturedFor": "<string>",
    "format": "jpeg",
    "hasDark": true,
    "height": 123,
    "source": "screenshot",
    "width": 123
  },
  "qrSettings": {
    "dotColor": "<string>",
    "dotStyle": "square",
    "frame": "none",
    "hideLogo": true,
    "markerBorder": "square",
    "markerCenter": "square",
    "markerColor": "<string>"
  }
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "fieldErrors": {},
  "traceId": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "code": "plan_requires_upgrade",
  "requestId": "<string>",
  "traceId": "<string>",
  "current_plan": "<string>",
  "required_capability": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>",
  "required_scope": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "code": "payload_too_large",
  "requestId": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "requestId": "<string>",
  "code": "<string>",
  "traceId": "<string>"
}

{
  "error": "<string>",
  "code": "internal_error",
  "requestId": "<string>",
  "traceId": "<string>"
}

Authorizations

Authorization

string

header

required

Workspace API key (lora_sk_…) sent as Authorization: Bearer <api_key>. Each scoped operation names the scope it requires in its security requirement, for example shortcuts.write; a key without it receives 403 with code: insufficient_scope. GET /v1/qr also accepts anonymous requests and requires no scope.

Path Parameters

handle

string

required

The shortcut's slug.

Body

application/json

The desired state of the shortcut at this slug. tagIds, aliases, and similar associations aren't accepted here — use POST /v1/shortcuts or PATCH /v1/shortcuts/{handle} for those.

destination

string

required

The shortcut's destination URL.

Required string length: 1 - 32000

Examples:

"https://google.com"

"mailto:hello@example.com"

"tel:+1234567890"

"notion://workspace/page"

title

string | null

Optional title for the shortcut

description

string | null

Optional description for the shortcut

visibility

enum<string>

Visibility level. Omit to keep the current value when updating an existing shortcut, or to default to WORKSPACE when creating a new one.

Available options:

PRIVATE,

WORKSPACE,

UNLISTED

masked

boolean

default:false

Whether to mask the destination URL

password

The password required to access the destination URL of the shortcut.

Required string length: 1 - 256

expiresAt

string<date-time> | null

The date and time when the shortcut expires.

dynamicRouting

DynamicRoutingRule · object[] | null

Ordered routing rules, evaluated top to bottom — the first rule whose conditions all match wins. Conditions within a rule are ANDed; values within a condition are ORed. Visitors matching no rule get the shortcut's default destination. At most 10 rules. Pass [] or null to remove all rules.

Maximum array length: 10

Show child attributes

folderId

string

The 8-character ID of an existing folder to assign the shortcut to. Defaults to the workspace's default folder when omitted.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$

Example:

"a1b2c3d4"

Response

The existing shortcut at this slug was updated.

A shortcut.

string<uuid>

required

The shortcut's unique ID.

slug

string

required

The shortcut slug.

url

string

required

Workspace-scoped shortcut URL. Open it to record a click and redirect to the destination.

Example:

"https://app.uselora.com/acme/short/handbook"

destination

string

required

The shortcut's destination URL.

title

string | null

required

description

string | null

required

icon

string | null

required

image

string | null

required

video

string | null

required

visibility

enum<string>

required

Available options:

PRIVATE,

WORKSPACE,

UNLISTED

archived

boolean

required

Whether the shortcut is archived. Defaults to false if not provided.

masked

boolean

required

passwordProtected

boolean

required

Whether this shortcut requires a password before redirecting. The password hash is never returned.

expiresAt

string | null

required

The date and time when the shortcut expires.

dynamicRouting

DynamicRoutingRule · object[] | null

required

Maximum array length: 10

Show child attributes

placeholders

PlaceholderDescriptor · object[]

required

Dynamic placeholders parsed from the destination URL, in template order (e.g. {query}). Empty for static destinations.

Show child attributes

folderId

string

required

The 8-character ID of the folder this shortcut belongs to.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$

Example:

"a1b2c3d4"

tagIds

string[]

required

The unique IDs of the tags assigned to the shortcut.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$

Example:

["a1b2c3d4"]

aliases

string[]

required

Additional handles that resolve to this shortcut in the same namespace as the canonical slug.

Required string length: 1 - 50

Pattern: ^[a-z0-9]([a-z0-9-_]*[a-z0-9])?$

Example:

["urlaub", "ferien"]

externalId

string | null

required

The shortcut ID in your system. If set, it can identify the shortcut in future API requests. The ext_ prefix is recommended on query parameters for visual disambiguation, but the server accepts prefixed and bare values. This key is unique across your workspace.

tenantId

string | null

required

The ID of the tenant that created the shortcut in your system. If set, it can be used to fetch all shortcuts for a tenant.

comments

string | null

required

Comments about the shortcut.

workspaceId

string

required

ID of the workspace the shortcut belongs to.

userId

string

required

ID of the user who created the shortcut.

createdAt

string

required

ISO 8601 creation timestamp.

updatedAt

string

required

ISO 8601 timestamp of the last update.

metadataSync

object

required

Whether title and description are still kept in sync with the destination automatically, or have been overridden by hand. The screenshot's own sync state is previewSettings.source.

Show child attributes

previewUrl

string | null

required

Resolved URL of the light preview image, or null when there is none. Usually the image described by previewSettings. It can also be set while previewSettings is null: a destination on a service Lora has brand art for falls back to a brand card, which is what a destination behind a login wall gets instead of a screenshot. Gate rendering on this field, not on previewSettings.assetId.

previewDarkUrl

string | null

required

Resolved URL of the dark preview image, or null when the preview has no dark variant. Always null when previewUrl is a brand card.

additionalFolderIds

string[]

required

Short IDs of ADDITIONAL folders this shortcut appears in, excluding its primary folder (folderId). Empty array when it only lives in its primary folder. Settable at create; curate afterwards via the folder items endpoints. Folders you cannot see are omitted.

Pattern: ^[0-9abcdefghjkmnpqrstvwxyz]{8}$

Example:

["a1b2c3d4"]

iconSettings

object | null

Structured icon recipe (glyph + background). null when the default monogram-on-neutral design is used.

Show child attributes

previewSettings

object | null

Stored destination screenshot for the hover preview. null when none has been resolved yet; source: "none" when the owner declined one. Use the resolved previewUrl / previewDarkUrl to render it — assetId, blobHost and format describe where and how the file is stored. format is jpeg for every preview stored today, and webp or png for older ones; blobHost is not accepted on a write.

Show child attributes

qrSettings

object | null

Saved QR code design for this shortcut. null when the default design is used. Customization requires a paid plan.

Show child attributes

Lora API

Shortcuts

Tags

Folders

QR Codes

Upsert shortcut

Authorizations

Path Parameters

Body

Response