> ## Documentation Index > Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt > Use this file to discover all available pages before exploring further. # My Apps > List, add, update, and delete apps in your appeeky.com tracked app list Manage the apps you track in your [appeeky.com](https://appeeky.com) account. These are the same apps visible under **My Apps** in the web dashboard. Appeeky My Apps Dashboard All My Apps endpoints cost **0 credits** and require the `apps:read` scope for reads and `apps:write` for writes. *** ## List My Apps ``` GET /v1/user/apps ``` Returns all apps in your tracked list, ordered by most recently added. ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}} curl "https://api.appeeky.com/v1/user/apps" \ -H "X-API-Key: YOUR_API_KEY" ``` ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}} const res = await fetch("https://api.appeeky.com/v1/user/apps", { headers: { "X-API-Key": "YOUR_API_KEY" }, }); const { data } = await res.json(); ``` ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}} import requests res = requests.get( "https://api.appeeky.com/v1/user/apps", headers={"X-API-Key": "YOUR_API_KEY"}, ) data = res.json()["data"] ``` **Response (200 OK):** ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "data": [ { "id": "c3f0961b-e252-469b-9d5e-d294d721032e", "app_id": 6443843426, "app_name": "Appeeky", "app_icon_url": "https://...", "developer_name": "Appeeky Inc.", "bundle_id": "com.appeeky.app", "subtitle": "ASO & Keyword Intelligence", "description": "...", "languages": ["en", "tr"], "is_live": true, "category": "Productivity", "platform": "ios", "created_at": "2026-03-19T15:47:06.270736+00:00" } ] } ``` *** ## Add an App ``` POST /v1/user/apps ``` Add an app to your tracked list by its numeric App Store ID. **Request Body:** | Field | Type | Required | Description | | --------------- | --------- | -------- | ----------------------------------------------------------- | | `appId` | number | Yes | Numeric Apple App Store ID | | `appName` | string | No | App display name | | `developerName` | string | No | Developer name | | `bundleId` | string | No | Bundle identifier (e.g. `com.example.app`) | | `subtitle` | string | No | App subtitle | | `description` | string | No | App description | | `languages` | string\[] | No | Supported language codes | | `isLive` | boolean | No | Whether the app is live on the App Store (default: `false`) | | `category` | string | No | App category | | `platform` | string | No | `ios`, `macos`, or `tvos` (default: `ios`) | ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}} curl -X POST "https://api.appeeky.com/v1/user/apps" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"appId": 6443843426, "appName": "Appeeky", "platform": "ios"}' ``` ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}} const res = await fetch("https://api.appeeky.com/v1/user/apps", { method: "POST", headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ appId: 6443843426, appName: "Appeeky", platform: "ios" }), }); const { data } = await res.json(); ``` ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}} import requests res = requests.post( "https://api.appeeky.com/v1/user/apps", headers={"X-API-Key": "YOUR_API_KEY"}, json={"appId": 6443843426, "appName": "Appeeky", "platform": "ios"}, ) data = res.json()["data"] ``` **Response (201 Created):** Returns the created app row. *** ## Update an App ``` PATCH /v1/user/apps/:appId ``` Update metadata for an app in your list. Only provide the fields you want to change. **Path Parameters:** | Name | Type | Description | | ------- | ------ | ----------------------------------------- | | `appId` | number | Numeric App Store ID of the app to update | **Request Body:** Same optional fields as Add (all optional). ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}} curl -X PATCH "https://api.appeeky.com/v1/user/apps/6443843426" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"isLive": true, "category": "Productivity"}' ``` ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}} const res = await fetch("https://api.appeeky.com/v1/user/apps/6443843426", { method: "PATCH", headers: { "X-API-Key": "YOUR_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ isLive: true, category: "Productivity" }), }); const { data } = await res.json(); ``` ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}} import requests res = requests.patch( "https://api.appeeky.com/v1/user/apps/6443843426", headers={"X-API-Key": "YOUR_API_KEY"}, json={"isLive": True, "category": "Productivity"}, ) data = res.json()["data"] ``` **Response (200 OK):** Returns the updated app row. *** ## Remove an App ``` DELETE /v1/user/apps/:appId ``` Remove an app from your tracked list. **Path Parameters:** | Name | Type | Description | | ------- | ------ | ----------------------------------------- | | `appId` | number | Numeric App Store ID of the app to remove | ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}} curl -X DELETE "https://api.appeeky.com/v1/user/apps/6443843426" \ -H "X-API-Key: YOUR_API_KEY" ``` ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}} const res = await fetch("https://api.appeeky.com/v1/user/apps/6443843426", { method: "DELETE", headers: { "X-API-Key": "YOUR_API_KEY" }, }); const { data } = await res.json(); // { success: true } ``` ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}} import requests res = requests.delete( "https://api.appeeky.com/v1/user/apps/6443843426", headers={"X-API-Key": "YOUR_API_KEY"}, ) ``` **Response (200 OK):** ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "data": { "success": true } } ``` *** ## Errors | Status | Code | When | | ------ | ---------------- | ----------------------------------------- | | 400 | `BAD_REQUEST` | `appId` missing or not a number | | 403 | `FORBIDDEN` | Key scope does not allow this operation | | 404 | `USER_NOT_FOUND` | No appeeky.com account linked to this key | | 404 | `NOT_FOUND` | App not found in your list | | 409 | `DUPLICATE` | App already in your list |