Short Links (Slugs) and Redirects

1. Open your handle

   Go to https://app.{PUBLIC_DOMAIN} and navigate to your handle's Links section.

2. Create or edit

   Click Create Link to add a new link, or click an existing link to edit it.

3. Configure

   Set the destination URL, slug, and optional fields (title, tags, categories, description).

4. Save and test

   Save the link. It is immediately live. Test by visiting https://{handle}.{PUBLIC_DOMAIN}/{slug} in an incognito window.

Create or update a link

This is an upsert — if the slug does not exist, it creates the link; if it does, it updates it.

    curl -sS -X PUT "https://api.10x.in/v2/handles/{handle}/links/{slug}" \
      -H "Authorization: Bearer <access-token>" \
      -H "Content-Type: application/json" \
      -d '{"destinationUrl": "https://example.com/product", "title": "Product Page", "tags": ["product", "q2"], "categories": ["marketing"], "enabled": true}'

    {
      "destinationUrl": "https://example.com/product",
      "title": "Product Page",
      "tags": ["product", "q2"],
      "categories": ["marketing"],
      "enabled": true
    }

Returns 200 with the full link object.

List all links

    curl -sS "https://api.10x.in/v2/handles/{handle}/links" \
      -H "Authorization: Bearer <access-token>"

Returns all links for the handle, sorted by creation date (newest first). Supports pagination.

Get a single link

    curl -sS "https://api.10x.in/v2/handles/{handle}/links/{slug}" \
      -H "Authorization: Bearer <access-token>"

Returns the full link object including metadata, routing rules, tracking policy, and version history.

Delete a link

    curl -sS -X DELETE "https://api.10x.in/v2/handles/{handle}/links/{slug}" \
      -H "Authorization: Bearer <access-token>"

PAT endpoints

The same operations are available via PAT at /v2/public/handles/{handle}/links and /v2/public/handles/{handle}/links/{slug}. Requires links.read or links.write scope.