Sync Smartlink

Refresh a smartlink by smartlink_id so destination and release data reflect the latest catalog state visible to the organization.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

smartlink_id*string

Public smartlink reference returned by the API.

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/smartlinks/1fdf8564-81f7-4607-9c8b-154b62db8d5f/sync"

{  "success": true,  "message": "Smartlink synced.",  "data": {    "smartlink_id": "1fdf8564-81f7-4607-9c8b-154b62db8d5f",    "release": {      "release_id": "b7a15d95-58f6-4f67-b5d1-89f4f5bfb4d8",      "title": "Midnight Atlas",      "status": "draft"    },    "slug": "nova-vale-midnight-atlas",    "title": "Midnight Atlas",    "status": "published",    "public_url": "https://links.northstar-distribution.co.uk/nova-vale-midnight-atlas",    "destinations": [      {        "platform": "spotify",        "url": "https://open.spotify.com/album/4Gj9kL2mN8rT6bY1xQvP3z",        "enabled": true      },      {        "platform": "apple_music",        "url": "https://music.apple.com/gb/album/midnight-atlas/1784529016",        "enabled": true      }    ],    "clicks": 1840,    "conversion_rate": 0.18,    "updated_at": "2026-07-04T10:15:00+00:00"  }}

Authorization

Path Parameters

Response Body

200application/json

401application/json

403application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`