Deep Links

Source: apps/api/src/routes/client/deep-links.ts.

Endpoints

Method	Path	Description
GET	`/client/deep-links/resolve/:slug`	Resolve a slug to its destination URL.
POST	`/client/deep-links/click`	Record a click (atomic INSERT + counter increment).
GET	`/client/deep-links/config`	Fetch the project's deep-link config (`url_scheme`, domain, fallback).

GET /client/deep-links/resolve/:slug

Response 200

{ "data": { "id": "…", "slug": "launch", "destination_url": "https://…", "metadata": {} } }

Errors

404 NOT_FOUND.

Try it:

GET/client/deep-links/resolve/%7B%7Bslug%7D%7D

client auth

curl -X GET 'https://api.amba.dev/client/deep-links/resolve/%7B%7Bslug%7D%7D'

Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/deep-links/resolve/{slug}' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

POST /client/deep-links/click

Inserts into link_clicks and increments tracked_links.click_count in a single tx. Captures X-Forwarded-For as ip_address.

Request

Field	Type	Required
`tracked_link_id`	uuid	yes
`platform`	string	no

Response 201

{ "data": { "tracked": true } }

Errors

500 CREATE_FAILED.

Try it:

POST/client/deep-links/click

client auth

curl -X POST 'https://api.amba.dev/client/deep-links/click'

Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X POST '${BASE_URL}/client/deep-links/click' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{}'

GET /client/deep-links/config

Returns public-safe config fields only (url_scheme, universal_link_domain, fallback_url). Returns data: null if no config exists (or on read failure — this endpoint never 500s).

Response 200

{
  "data": {
    "url_scheme": "myapp",
    "universal_link_domain": "app.example.com",
    "fallback_url": "https://example.com"
  }
}

Try it:

GET/client/deep-links/config

client auth

curl -X GET 'https://api.amba.dev/client/deep-links/config'

Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/deep-links/config' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

On this page