We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Developers

Update existing links

Use this endpoint to update existing links and sublinks for your app. You can add new partners to links or control whether ad spend data is enabled.

Before you begin

To use this endpoint, you need an Adjust API token. Follow the instructions in the authentication guide to get your token.

Endpoint

https://api.adjust.com/public/v1/apps/{app_token}/trackers/{tracker_token}

PATCH request

Update a link or sublink associated to your app.

Parameters

Parameter	Data type	In	Description
`app_token` *	String	Path	Your app's 12 digit identifier.
`tracker_token` *	String	Path	The token of the link you want to update.
`partner_id`	Integer	Body	The ID of the partner you want to attach to the link. You can use the partners endpoint to retrieve a list of partners and their IDs.
`cost_data_enabled`	Boolean	Body	Whether to enable ad spend data for the link.

Response

Field	Data type	Description	Example
`name`	String	The link's name.	`Adroll`
`label`	String	The last level part of the name of the link.	`Adroll`
`level`	Integer	The level of the link. Network = `1` Campaign = `2` Adgroup = `3` Creative = `4`	`1`
`archived`	Boolean	Whether the link is archived.	`true`
`has_subtrackers`	Boolean	Whether the link has sublinks.	`true`
`partner_id`	Integer	The ID of the partner attached to the link.	`3`
`cost_data_enabled`	Boolean	Whether the link has cost_data enabled.	`false`
`impression_url`	String	URL of the link for impression-based measurement.	`https://view.adjust.com/impression/abc123`
`url`	String	URL of the full link.	`https://app.adjust.com/abc123`
`click_url`	String	URL of the link for click measurement.	`https://app.adjust.com/abc123`

{
   "name": "String",
   "token": "String",
   "label": "String",
   "level": 1,
   "archived": false,
   "has_subtrackers": false,
   "partner_id": 3,
   "cost_data_enabled": false,
   "url": "String",
   "click_url": "String",
   "impression_url": "String"
}

Example

cURL

curl --location --request PATCH 'https://api.adjust.com/public/v1/apps/gwzpeepw8uf8/trackers/klm789' \
--header 'Authorization: Token token={API_TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "partner_id": 174,
  "cost_data_enabled": false
}'

{
  "data": {
    "api_version": "1",
    "request_id": "FcK55-tdJUDOWQIAABsB",
    "timestamp": "2019-09-09T09:07:06Z",
    "items": [
      {
        "name": "Adcolony",
        "token": "klm789",
        "label": "Adcolony",
        "level": 1,
        "archived": false,
        "has_subtrackers": false,
        "partner_id": 174,
        "cost_data_enabled": true,
        "url": "https://app.adjust.com/klm789",
        "impression_url": "https://s2s.adjust.com/impression/klm789?s2s=1&idfa=[IDFA]&gps_adid=[GOOGLE_AD_ID]&ip_address=  [IP_ADDRESS]&adcolony_click_id=[CLICK_ID]&android_id_upper_sha1=[SHA1_ANDROID_ID]&cost_id=[CLICK_ID]&cost_type=[BID_TYPE]&cost_amount=[BID]&cost_currency=USD,
        "click_url": "https://s2s.app.adjust.com/klm789?s2s=1&idfa=[IDFA]&gps_adid=[GOOGLE_AD_ID]&ip_address=[IP_ADDRESS]&adcolony_click_id=[CLICK_ID]&android_id_upper_sha1=[SHA1_ANDROID_ID]&cost_id=[CLICK_ID]&cost_type=[BID_TYPE]&cost_amount=[BID]&cost_currency=USD"
      }
    ]
  }
}