Update shortcut
All fields are optional. Omitted fields stay as-is. Renaming the slug runs the same reserved-word and uniqueness checks as create. archived is not editable here and will get its own endpoint.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The shortcut's slug or id (UUID).
Body
Partial shortcut update — all fields optional (PATCH semantics).
New unique short path. Omit to keep the existing slug.
1 - 50^[a-z0-9]([a-z0-9-_]*[a-z0-9])?$"handbook"
New destination URL. Same scheme rules as create (no javascript:/data:/file:).
32000"https://example.com/new-target"
New title. Pass null to clear.
New description. Pass null to clear.
New visibility level. One of PRIVATE, WORKSPACE, or UNLISTED.
PRIVATE, WORKSPACE, UNLISTED The password required to access the destination URL of the shortcut.
1 - 256The date and time when the short link will expire at.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$The iOS destination URL for the shortcut for iOS device targeting.
32000The Android destination URL for the shortcut for Android device targeting.
32000Geo targeting information for the short link in JSON format {[COUNTRY]: https://example.com }
Move the shortcut to a different folder, by its 8-character ID. The caller must have access to the target folder.
^[0-9abcdefghjkmnpqrstvwxyz]{8}$Replace the tag set. Pass the full set you want — existing tags not in this list are removed. Omit to leave tags untouched. Pass [] to clear all tags.
50^[0-9abcdefghjkmnpqrstvwxyz]{8}$The comments for the short link.
Response
The updated shortcut.
A shortcut.
The shortcut's unique ID.
The shortcut slug.
Workspace-scoped short link. Open this URL to record a click and redirect to the destination.
"https://app.uselora.com/acme/short/handbook"
The destination URL of the short link.
PRIVATE, WORKSPACE, UNLISTED, PUBLIC Whether the short link is archived. Defaults to false if not provided.
Whether this shortcut requires a password before redirecting. The password hash is never returned.
The date and time when the short link will expire at.
The iOS destination URL for the shortcut for iOS device targeting.
The Android destination URL for the shortcut for Android device targeting.
Geo targeting information for the short link in JSON format {[COUNTRY]: https://example.com }
Dynamic placeholders parsed from the destination URL. Empty for static destinations. See docs/dynamic-placeholders.md.
The 8-character ID of the folder this shortcut belongs to.
^[0-9abcdefghjkmnpqrstvwxyz]{8}$"a1b2c3d4"
The unique IDs of the tags assigned to the shortcut.
^[0-9abcdefghjkmnpqrstvwxyz]{8}$The ID of the link in your database. If set, it can be used to identify the link in future API requests (the ext_ prefix is recommended on query parameters for visual disambiguation but the server accepts both prefixed and bare values). This key is unique across your workspace.
The ID of the tenant that created the link inside your system. If set, it can be used to fetch all links for a tenant.
The comments for the short link.
ID of the workspace the shortcut belongs to.
ID of the user who created the shortcut.
ISO 8601 creation timestamp.
ISO 8601 timestamp of the last update.