Skip to content

Deploying

Custom subdomains

Pro accounts can claim a name like acme and show any drop they own at https://acme.ship.place/. Point it at another drop whenever you like: the drops keep their own slugs, URLs and revisions, and visitors see the switch within about 10 seconds. Point it at a named drop and it follows every redeploy.

On this page

Claim a name

POST

/links

sp_ key or ID token

Send the name, plus the drop to show as a slug or drop URL. Leave out slug to claim the name now and point it later. Claiming needs a verified Pro subscription: if billing can't be checked, the claim fails with a 503.

bash
curl -X POST https://ship.page/links \
  -H "Authorization: Bearer sp_QffDmo0..." \
  -H "Content-Type: application/json" \
  -d '{"name": "acme", "slug": "vivid-otter-a1b2c"}'
json201 Created
{
  "name": "acme",
  "slug": "vivid-otter-a1b2c",
  "url": "https://acme.ship.place/"
}
StatusDescription
400bad requestinvalid_link_name or link_name_reserved: the name breaks the name rules. invalid_request: the body isn't a JSON object.
402payment requiredsubscription_required: no active Pro plan on the account.
404not founddrop_not_found: slug isn't a live drop on your account.
409conflictlink_name_taken: someone else holds the name. link_exists: it's already yours, repoint it instead. link_limit_reached: you already hold all your plan allows (5 on Pro, 25 on Team).
429rate limitedrate_limited: too many link changes. Claims, repoints and releases share one limit per account.
503unavailablebackend_unavailable: billing couldn't be verified. Try again shortly.

Check a name

Point it elsewhere

List your links

Release a name

Name rules

Length
3-40 characters of a-z, 0-9 and hyphens.
Hyphens
Starts and ends with a letter or digit. No double hyphens.
Slugs
Can't look like a generated slug (word-word-xxxxx) or match an existing one.
Reserved
Infrastructure and service words (www, api, mail, admin, status, docs, app, staging...), brand names and lookalikes (paypal, paypa1, rnicrosoft) and credential bait (login, verify, wallet, billing...). Names made only of reserved words, like new-dashboard, are reserved too.
Per account
Up to 5 on Pro, 25 on Team. Test a name with the name check before you claim it.

When your plan ends

Links keep serving for 30 days after your Pro or Team plan ends; claiming and repointing wait until you subscribe again. After that they pause and visitors get a 404 until you resubscribe. Your names are kept for 90 days without a plan, then released and held for 30 days so only you can claim them back.

Takedowns

If the page a link shows is taken down for abuse, the link is frozen with it: it serves the takedown notice and can't be repointed or released (409 link_frozen).

Last updated Jun 12, 2026