Create shortcut
Creates a short link in the workspace.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Payload to create a new shortcut
The shortcut slug.
1 - 50^[a-z0-9]([a-z0-9-_]*[a-z0-9])?$"handbook"
The destination URL of the short link.
32000"https://google.com"
"mailto:hello@example.com"
"tel:+1234567890"
"notion://workspace/page"
Optional title for the shortcut
Optional description for the shortcut
Legacy baked icon URL. Superseded by iconSettings, which stores the render recipe instead of the artifact.
Structured icon recipe (glyph + background). Omit to auto-resolve a favicon from the destination at create time. Pass null to keep the default monogram-on-neutral design.
Optional image URL
Optional video URL
Visibility level of the shortcut
PRIVATE, WORKSPACE, UNLISTED Whether to mask the destination URL
The password required to access the destination URL of the shortcut.
1 - 256The date and time when the short link will expire at.
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.
10The 8-character ID of an existing folder to assign the shortcut to. Defaults to the workspace's default folder when omitted.
^[0-9abcdefghjkmnpqrstvwxyz]{8}$"a1b2c3d4"
The unique IDs of the tags assigned to the shortcut.
50^[0-9abcdefghjkmnpqrstvwxyz]{8}$Saved QR code design. Pass null to use the default design. Customization requires a paid plan.
Short IDs of additional folders this shortcut should appear in, excluding its primary folder (folderId).
20^[0-9abcdefghjkmnpqrstvwxyz]{8}$Response
The created 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 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.
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.
10Dynamic 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.
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.
^[0-9abcdefghjkmnpqrstvwxyz]{8}$Structured icon recipe (glyph + background). null when the default monogram-on-neutral design is used.
Saved QR code design for this shortcut. null when the default design is used. Customization requires a paid plan.