> ## Documentation Index > Fetch the complete documentation index at: https://docs.taap.it/llms.txt > Use this file to discover all available pages before exploring further. # Update Link > Update an existing link's properties Update properties of an existing link including URL, password, and expiration settings. **Request:** ```bash cURL theme={null} curl -X PUT 'https://api.taap.it/v1/links/link_987654321' \ -H 'Authorization: Bearer taapit_your_api_key_here' \ -H 'Content-Type: application/json' \ -d '{ "name": "Updated Marketing Link", "description": "Updated description for campaign", "original_url": "https://example.com/updated-url", "code": "updated-code", "app": "UpdatedApp", "app_logo": "https://example.com/new-logo.png", "android_link": "updatedapp://open?url=https://example.com", "ios_link": "updatedapp://open?url=https://example.com", "windows_link": "ms-windows-store://pdp/?productid=9NBLGGH987654", "macos_link": "macappstore://itunes.apple.com/app/updatedapp/id987654321", "whatsapp_message": "Check out this updated link!", "metadata": { "title": "Updated Product", "description": "Check out our updated product", "favicon": "https://example.com/new-favicon.ico", "social_image": "https://example.com/new-social-image.jpg" }, "qr_code_options": { "size": 250, "color": "#FF0000", "background_color": "#FFFFFF", "logo": "https://example.com/new-logo.png", "logo_size": 60, "error_correction_level": "H" }, "utm_name": "updated_campaign", "utm_source": "social", "utm_medium": "facebook", "utm_campaign": "updated2024", "utm_term": "updated_marketing", "utm_content": "updated_cta_button", "utm_template_id": "template_456", "referrer": "https://facebook.com", "password": "newpassword123", "password_description": "Enter new password to access link", "excluded_countries": [ { "code": "CA", "label": "Canada", "phone": "+1", "suggested": false, "lang": "en", "continent": "North America" } ], "has_public_stat": false, "enable_conversion_tracking": true, "is_archived": false, "expiration_date": "2024-06-30T23:59:59Z", "expiration_click_count": 500, "pixel_id": "pixel_789123456" }' ``` **Response:** ```json theme={null} { "id": "link_987654321", "created_at": "2024-01-15T10:30:00Z", "updated_at": "2024-01-15T11:00:00Z", "project_id": "project_123456789", "domain_id": "domain_987654321", "pixel_id": "pixel_789123456", "original_url": "https://example.com/updated-url", "name": "Updated Marketing Link", "description": "Updated description for campaign", "code": "updated-code", "app": "UpdatedApp", "app_logo": "https://example.com/new-logo.png", "android_link": "updatedapp://open?url=https://example.com", "ios_link": "updatedapp://open?url=https://example.com", "windows_link": "ms-windows-store://pdp/?productid=9NBLGGH987654", "macos_link": "macappstore://itunes.apple.com/app/updatedapp/id987654321", "whatsapp_message": "Check out this updated link!", "metadata": { "title": "Updated Product", "description": "Check out our updated product", "favicon": "https://example.com/new-favicon.ico", "social_image": "https://example.com/new-social-image.jpg" }, "qr_code_options": { "size": 250, "color": "#FF0000", "background_color": "#FFFFFF", "logo": "https://example.com/new-logo.png", "logo_size": 60, "error_correction_level": "H" }, "utm_name": "updated_campaign", "utm_source": "social", "utm_medium": "facebook", "utm_campaign": "updated2024", "utm_term": "updated_marketing", "utm_content": "updated_cta_button", "utm_template_id": "template_456", "referrer": "https://facebook.com", "password": "newpassword123", "password_description": "Enter new password to access link", "excluded_countries": [ { "code": "CA", "label": "Canada", "phone": "+1", "suggested": false, "lang": "en", "continent": "North America" } ], "has_public_stat": false, "enable_conversion_tracking": true, "is_archived": false, "expiration_date": "2024-06-30T23:59:59Z", "expiration_click_count": 500, "clicks": 42 } ``` ## Authorization Bearer token for API authentication. Format: `Bearer YOUR_API_KEY` ## Path Parameters Unique identifier for the link ## Request Body All parameters are optional for updates. Only include the fields you want to update. ### Core Parameters Updated name for the link Updated description for the link Updated URL to be shortened. Supports http, https, mailto, tel, sms, whatsapp, tg, skype schemes. Updated short code for the link Updated tracking pixel ID to associate with this link Updated project ID to associate with this link ### Deep Linking Parameters Updated name of the mobile app for deep linking Updated URL to the app logo image Updated Android deep link URL (e.g., myapp\://open?url=...) Updated iOS deep link URL (e.g., myapp\://open?url=...) Updated Windows deep link URL (e.g., ms-windows-store://...) Updated macOS deep link URL (e.g., macappstore://...) Updated pre-filled message for WhatsApp sharing ### Metadata Parameters Updated link metadata for website previews Updated page title for link previews Updated page description for link previews Updated URL to favicon image Updated URL to social media preview image Updated QR code generation options Updated QR code size in pixels Updated QR code color (hex format, e.g., #000000) Updated QR code background color (hex format, e.g., #ffffff) Updated URL to logo image to embed in QR code Updated logo size in pixels Updated error correction level (L, M, Q, H) ### UTM Parameters Updated UTM campaign name Updated UTM source (e.g., email, social, google) Updated UTM medium (e.g., newsletter, post, cpc) Updated UTM campaign identifier Updated UTM term (keywords) Updated UTM content (e.g., cta\_button, banner) Updated UTM template identifier Updated referrer URL ### Security & Access Parameters Updated password to protect the link (requires plan feature) Updated description shown when password is required Updated array of countries to exclude from accessing the link Country code (ISO 3166-1 alpha-2) Country name Country phone code Whether this country is suggested for exclusion Primary language code Continent name Updated setting for whether link statistics are publicly accessible ### Conversion Tracking Parameters Updated setting for whether conversion tracking is enabled on this link ### Status Parameters Updated archive status of the link ### Expiration Parameters Updated ISO 8601 datetime when link expires (requires plan feature) Updated maximum number of clicks before link expires (requires plan feature)