> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reqlick.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new link

> Create a new link for the authenticated workspace.



## OpenAPI

````yaml POST /links/new/{workspace}
openapi: 3.0.0
info:
  title: Reqlick API
  version: 1.0.0
  description: Reqlick API Documentation
servers:
  - url: https://api.reqlick.com
security:
  - bearerAuth: []
tags:
  - name: Documents
    description: Documents management
  - name: Domains
    description: Domains management
  - name: GoogleAuth
    description: Google Authentication
  - name: Links
    description: Links management
  - name: Payments
    description: Payments management
  - name: QRCodes
    description: QR Codes management
  - name: Resources
    description: Resources management
  - name: Subscriptions
    description: Subscription management
  - name: Users
    description: User management and authentication
  - name: Workspaces
    description: Workspaces management
paths:
  /links/new/{workspace}:
    post:
      tags:
        - Links
      summary: Create a new short link
      parameters:
        - name: workspace
          in: path
          required: true
          description: The URL of the workspace where the short link will be created
          schema:
            type: string
        - in: query
          name: subscriptionId
          required: true
          description: The subscription ID associated with the workspace
          schema:
            type: string
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: The social card image file to upload
                domain:
                  type: string
                  description: The domain under which the link will be created
                  default: rqk.sh
                key:
                  type: string
                  description: The key to be used for the link
                  default: null
                url:
                  type: string
                  description: The URL the link points to
                  example: https://example.com
                  default: ''
                isPublic:
                  type: boolean
                  nullable: true
                  description: Visibility of the link
                description:
                  type: string
                  default: >-
                    Turn your files into shareable links and connect
                    effortlessly
                  description: Description of the social card link
                title:
                  type: string
                  nullable: true
                  default: Instant File Sharing Link with Reqlick
                  description: Title of the social card link
                image:
                  type: string
                  nullable: true
                  default: /_static/thumbnail.png
                  description: URL of the image associated with the link
                expiresAt:
                  type: string
                  format: date-time
                  nullable: true
                  default: null
                  description: Expiration date and time of the link
                password:
                  type: string
                  nullable: true
                  default: null
                  description: Password required to access the link
                ios:
                  type: string
                  nullable: true
                  default: null
                  description: iOS-specific information
                android:
                  type: string
                  nullable: true
                  default: null
                  description: Android-specific information
                utm_source:
                  type: string
                  nullable: true
                  default: null
                  description: UTM source parameter for tracking
                utm_medium:
                  type: string
                  nullable: true
                  default: null
                  description: UTM medium parameter for tracking
                utm_campaign:
                  type: string
                  nullable: true
                  default: null
                  description: UTM campaign parameter for tracking
                utm_term:
                  type: string
                  nullable: true
                  default: null
                  description: UTM term parameter for tracking
                utm_content:
                  type: string
                  nullable: true
                  default: null
                  description: UTM content parameter for tracking
                ref:
                  type: string
                  nullable: true
                  default: null
                  description: Referral information
      responses:
        '200':
          description: Link or QR code link created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  link_id:
                    type: string
                    description: The ID of the created link
                  link_url:
                    type: string
                    description: The short URL of the created Link
        '400':
          description: Missing or invalid parameters
        '401':
          description: Invalid subscription or unauthorized access
        '403':
          description: Subscription limits exceeded or deactivated account
        '422':
          description: Key already exists or workspace not found
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````