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

# Bulk update links

> Requires the `links:write` scope and a plan with bulk operations, from Pro. Applies the same change to up to 100 links. It can't set
`customSlug`, since an alias belongs to one link. A link that fails doesn't stop the others,
so check `errors`. Limited to 30 bulk requests per minute per account.




## OpenAPI

````yaml PATCH /links/bulk
openapi: 3.1.0
info:
  title: URLdn API
  version: 1.0.0
  description: >
    Create and manage short links, tags and custom domains, read click
    analytics, generate

    QR codes and ask the AI analyst. Included on every plan, with limits by
    plan. Limits apply

    to your whole account, across all its keys.


    Keep API keys on your server: anything in front-end code can be read by
    anyone.
servers:
  - url: https://api.urldn.com/v1
security:
  - apiKey: []
tags:
  - name: Links
  - name: Tags
  - name: Domains
  - name: Analytics
  - name: QR codes
  - name: AI analyst
  - name: Account
paths:
  /links/bulk:
    patch:
      tags:
        - Links
      summary: Bulk update links
      description: >
        Requires the `links:write` scope and a plan with bulk operations, from
        Pro. Applies the same change to up to 100 links. It can't set

        `customSlug`, since an alias belongs to one link. A link that fails
        doesn't stop the others,

        so check `errors`. Limited to 30 bulk requests per minute per account.
      operationId: bulkUpdateLinks
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - linkIds
                - data
              properties:
                linkIds:
                  type: array
                  minItems: 1
                  maxItems: 100
                  uniqueItems: true
                  items:
                    type: string
                    pattern: ^[a-f0-9]{24}$
                data:
                  type: object
                  additionalProperties: false
                  minProperties: 1
                  properties:
                    url:
                      type: string
                      format: uri
                      maxLength: 2048
                    domain:
                      type:
                        - string
                        - 'null'
                      description: null moves the links back to the default domain
                    title:
                      type:
                        - string
                        - 'null'
                      maxLength: 120
                    tags:
                      type: array
                      maxItems: 20
                      items:
                        type: string
                        maxLength: 40
                    isActive:
                      type: boolean
      responses:
        '200':
          description: The links updated, and the ones that failed
          content:
            application/json:
              schema:
                type: object
                required:
                  - updated
                  - errors
                properties:
                  updated:
                    type: array
                    items:
                      $ref: '#/components/schemas/Link'
                  errors:
                    type: array
                    items:
                      allOf:
                        - $ref: '#/components/schemas/Error'
                        - type: object
                          required:
                            - id
                          properties:
                            id:
                              type: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  schemas:
    Link:
      type: object
      required:
        - id
        - shortUrl
        - shortCode
        - url
        - domain
        - title
        - tags
        - isActive
        - isQrCode
        - hasPassword
        - expiresAt
        - createdAt
      properties:
        id:
          type: string
        shortUrl:
          type: string
          format: uri
        shortCode:
          type: string
        url:
          type: string
          format: uri
          description: The destination
        domain:
          type:
            - string
            - 'null'
          description: Your custom domain, or null for the default
        title:
          type:
            - string
            - 'null'
        tags:
          type: array
          items:
            type: string
        isActive:
          type: boolean
        isQrCode:
          type: boolean
        hasPassword:
          type: boolean
        expiresAt:
          type:
            - string
            - 'null'
          format: date-time
        createdAt:
          type: string
          format: date-time
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: A stable machine-readable code
          examples:
            - quota_exceeded
        message:
          type: string
        details:
          type: object
          additionalProperties: true
  responses:
    BadRequest:
      description: >-
        `invalid_request`, `invalid_json`, `invalid_cursor` or
        `blocked_destination`
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: '`missing_api_key`, `invalid_api_key` or `revoked_api_key`'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: '`plan_required`, `insufficient_scope` or `domain_not_allowed`'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    RateLimited:
      description: >-
        `rate_limited`, `monthly_quota_exceeded` or `too_many_auth_failures`.
        Wait for `Retry-After` seconds.
      headers:
        Retry-After:
          description: Seconds to wait before retrying
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'Your API key: `Authorization: Bearer urldn_live_...`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.