Short URLs

Create a standalone short URL

Creates a new standalone short URL (not linked to a QR code). A unique 5-character short code is automatically generated. Optionally assign a custom domain and set the active state.

post/short-url

Request

  • Base URL: https://api.qrcodly.de/api/v1
  • URL: https://api.qrcodly.de/api/v1/short-url
  • Auth: HTTP bearer

Request body

destinationUrlstring uri required

The destination URL to redirect to (must start with http:// or https://)

isActiveboolean required

Whether the short URL should be active immediately (default: true)

customDomainIdstring uuid nullable required

ID of the custom domain used for this short URL, or null for the default domain

namestring nullable required

User-defined name for the short URL (max 50 characters)

Response

Default Response

idstring uuid required

Unique identifier (UUID v4)

createdAtstring date-time required

Timestamp when the resource was created (ISO 8601)

updatedAtstring date-time nullable required

Timestamp when the resource was last updated (ISO 8601), or null if never updated

shortCodestring required

Unique 5-character short code (e.g. "Ab3xZ")

namestring nullable required

User-defined name for the short URL (max 50 characters)

destinationUrlstring uri nullable required

The target URL that the short URL redirects to

qrCodeIdstring uuid nullable required

ID of the linked QR code, or null for standalone short URLs

isActiveboolean required

Whether the short URL is currently active and redirecting

createdBystring required

User ID of the short URL owner

deletedAtstring date-time nullable required

Soft-delete timestamp, or null if the short URL is active

safetyStatus'unchecked' | 'clean' | 'blocked' required

Result of the destination safety screening. "blocked" means we disabled the link and the owner cannot re-enable it

safetyBlockedAtstring date-time nullable required

When the link was blocked for safety reasons, or null

safetyThreatTypesstring nullable required

Comma-separated Google Web Risk threat types behind the block, or null

Changes

No recorded changes to this operation across all 1 revision of this API.