---
title: "Tracked Applications - Update"
method: PUT
path: "/user/tracked_applications"
tags: ["Tracked Applications"]
---

# Tracked Applications - Update

`PUT /user/tracked_applications`

## Request

- Base URL: `https://public-api.apptweak.com/api/public/apptweak`
- URL: `https://public-api.apptweak.com/api/public/apptweak/user/tracked_applications`
- Auth: API key in header `x-apptweak-key`

Update applications that you're tracking by changing the app id, country, language and device. <br/><br/> <b>Price</b> <table> <thead><tr><th>Datapoint</th><th>Description</th><th>Credits/request</th></tr></thead> <tbody> <tr><td><b>-</b></td><td>The tracking entry after the update</td><td>1</td></tr> </tbody> </table>

## Query parameters

- `id` string, required

## Request body

- object
  - `application_id` string: App ID to be tracked.
  - `country` string: Two-letter country code (`us`, `gb`, `fr`). Accepted values: <a href="https://developers.apptweak.com/reference/countries-1" target="_blank"><code>GET /api/public/apptweak/countries</code></a> with `store=ios` or `store=android`. The country to track the application in.
  - `language` string: AppTweak language code, not always ISO: US English is `us`, US Spanish `sp`. Accepted pairs: <a href="https://developers.apptweak.com/reference/languages-1" target="_blank"><code>GET /api/public/apptweak/languages</code></a> with `store=ios` or `store=android`. The language to track the application in.
  - `device` 'iphone' | 'ipad' | 'android': The device for which the application will be tracked. Available options: iphone, ipad, android.

## Response `200`

Successful response.

- object
  - `result` object
    - `id` string
    - `application_id` string
    - `country` string
    - `language` string
    - `device` string
    - `created_at` string
  - `metadata` object
    - `request` object
      - `path` string
      - `params` object
      - `cost` integer
      - `max_credit_cost` integer
      - `status` integer
      - `body` object
    - `response` object, nullable

## Other responses

- `401`: Unauthorized. Unknown or missing API token.
- `403`: Forbidden. Not enough credits to perform the request.
- `422`: Validation error. Returned when the `id` query parameter is missing, when the request body is empty or contains a property other than `application_id`, `country`, `language` and `device`, when no tracked application matches the given `id`, or when the tracked application cannot be updated with the provided values.

---

[API](https://skmtc.dev/apptweak/apis/apptweak-api.md) - [All operations](https://skmtc.dev/apptweak/apis/apptweak-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apptweak/apis/apptweak-api/revisions/76dfd41ade5d?raw)