Change domains

Two changes that touch many links at once, each with a preview that writes nothing and an apply call that does the work:

• Destination domain. The website your links open moved from old-site.com to new-site.com. Every link pointing at the old domain is rewritten, with its path and query string kept. The short links stay the same.
• Short domain. The short links themselves move, keeping their code: ivi.to/spring becomes go.yourbrand.com/spring.

Both work on the whole workspace, or on the links you list in links. They are the same changes as Change destination domain and Change short domain on the links page in the app.

curl -X POST "https://urlicer.com/api/v1/links/destination-domain/preview" \
  -H "Authorization: Bearer url_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "old-site.com", "to": "new-site.com"}'

{
  "from": "old-site.com",
  "to": "new-site.com",
  "matched": 2,
  "samples": [
    {
      "link": "ivi.to/TGPs",
      "url": "https://old-site.com/b",
      "newUrl": "https://new-site.com/b",
      "alsoChanges": null
    },
    {
      "link": "ivi.to/spring",
      "url": "https://old-site.com/a?x=1",
      "newUrl": "https://new-site.com/a?x=1",
      "alsoChanges": "the fallback"
    }
  ],
  "notIncluded": ["www.old-site.com (3 links)"]
}

curl -X POST "https://urlicer.com/api/v1/links/destination-domain" \
  -H "Authorization: Bearer url_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "old-site.com", "to": "new-site.com"}'

{"changed": 2, "done": true, "cursor": 124109}

curl -X POST "https://urlicer.com/api/v1/links/short-domain/preview" \
  -H "Authorization: Bearer url_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from": "ivi.to", "to": "go.yourbrand.com"}'

{
  "from": "ivi.to",
  "to": "go.yourbrand.com",
  "matched": 2,
  "samples": [
    {"link": "ivi.to/TGPs", "newLink": "go.yourbrand.com/TGPs"},
    {"link": "ivi.to/spring", "newLink": "go.yourbrand.com/spring"}
  ],
  "notMoving": ["1 code is already taken on go.yourbrand.com: sale."]
}

curl -X POST "https://urlicer.com/api/v1/links/short-domain" \
  -H "Authorization: Bearer url_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "go.yourbrand.com", "links": [{"code": "spring"}, {"code": "TGPs", "domain": "ivi.to"}]}'

{"moved": 2, "skipped": 0, "done": true, "cursor": 124109}

Applying a large change

Apply changes at most 300 links per call and answers done and a cursor. Until done is true, send the same body again with that cursor. Each call counts as one request against your per-minute limit. If a call fails part way, the links already changed stay changed, and starting again from the last cursor you received finishes the rest.

Moving a short link breaks its old address. The old short URL stops resolving at once, including from printed QR codes, and its code becomes free for anyone to use. Run the preview first, and keep links whose old address is printed or widely shared on their current domain.

Links that stay where they are

A short domain move leaves a link on its current domain, and the preview lists it under notMoving, when:

• its code is already in use on the new domain;
• it fires retargeting pixels and the new domain cannot run them (ivi.to never can; your own domain can once it has a business name and a privacy policy link);
• it moves to ivi.to with a custom alias shorter than your plan allows there.

What else happens

Each changed link sends a link.updated webhook, and each apply call is one entry in the workspace's audit log, naming your API key.