Change your listing

What you can change

• The URL — and the title, description and image are re-scraped from the new page.
• The registered email — the address that controls the listing.

Tier changes go through /pricing, and removals through [email protected].

Step 1 — find your listing id

It is the number in your listing page URL, curlship.com/l/1234. Agents can find it in GET /api/listings by matching the url field, or check one with GET /api/listing/1234.

Step 2 — prove the listing is yours

Two ways. Pick whichever you can actually do.

By email (simplest)

We mail a one-time link to the address the listing was submitted with. Opening it shows you the pending change; a button applies it. The link expires in 24 hours and works once.

$ curl -X POST https://curlship.com/api/edit-request \
    -H "Content-Type: application/json" \
    -d '{"listing_id": 2142, "url": "https://new-url.example/", "proof": "email"}'

# → {"ok": true, "request_id": 7, "status": "pending",
#    "message": "Confirmation link sent to the registered address (yo***@example.com)."}

By domain (when you no longer hold that mailbox)

We give you a token. Publish it at /.well-known/curlship-verify.txt (on its own line) or as <meta name="curlship-verify" content="…"> on both the currently listed site and the new one, then confirm.

$ curl -X POST https://curlship.com/api/edit-request \
    -H "Content-Type: application/json" \
    -d '{"listing_id": 2142, "url": "https://new-url.example/", "proof": "domain"}'

# → token + exactly which files to publish, on which sites

# publish it on BOTH sites, then:
$ curl -X POST https://curlship.com/api/edit-confirm \
    -H "Content-Type: application/json" \
    -d '{"request_id": 7, "token": "the-token-we-gave-you"}'

Why both? Publishing the token only on the new domain proves you own the destination, not the listing — anyone can do that for a site they want someone else's listing to point at. So that case is refused, and so is a domain proof when the currently listed site is already dead. If neither proof is possible, write to support and a human reviews it.

Step 3 — re-add your badge

A URL change resets the badge check, so a free listing is nofollow until the badge is found on the new site. Add it and verify it instantly to flip back to dofollow.

If it wasn't you

Every applied change is emailed to the registered address with an undo link valid for 7 days, and each changed field is stored with its previous value. A change made behind your back is visible and reversible.

Limits

• 5 edit requests per hour per IP, 3 per day per listing.
• Requests expire after 24 hours and can be confirmed once.
• Changing the registered email always needs the emailed link — a domain proof cannot move the contact address.

Full API reference: /docs · machine-readable: /openapi.json · agent brief: /llms.txt · the rules: /terms.