Bulk Create/Update Links

Create or update multiple links (same as POST).

Requires:

Feature: links.bulk
Workspace type: Extended only

Blocked by: Revoked workspace.

put/links/bulk

Request

Base URL
https://api.rebrandly.com/v1
URL
https://api.rebrandly.com/v1/links/bulk
Auth
API key in header apikey

Headers

Workspacestring

Example:workspace123abc

Workspace public ID

apikeystring required

API key for authentication

Request body

destinationstring uri required

Target URL where the link redirects

slashtagstring

Custom URL path (auto-generated if not provided)

domainIdstring

Domain public ID to use for the link

titlestring

Human-readable title

descriptionstring

Link description (requires links.notes feature)

ttlinteger

Time to live in seconds (requires links.expiration feature)

passwordstring

Password protection (requires links.password feature)

httpsboolean

Enable HTTPS

Example request

[
  {
    "destination": "https://example.com/page",
    "slashtag": "my-custom-link"
  }
]

Response

Bulk operation result

countinteger

Number of links processed

Example response

{
  "links": [
    {
      "id": "abc123def456",
      "title": "My Example Link",
      "slashtag": "my-link",
      "destination": "https://example.com",
      "shortUrl": "rebrand.ly/my-link",
      "domainId": "domain123abc",
      "domainName": "rebrand.ly",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z",
      "status": "active",
      "description": "This link redirects to our example page",
      "https": true
    }
  ]
}

Changes

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