---
updatedAt: 2026-06-08T03:35:06.000Z
agentTools:
  projectIndex: https://developer.moloco.cloud/llms.txt
---

# Update an existing TrackingLink.

Update an existing TrackingLink.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Moloco Ads Campaign Management API",
    "description": "Moloco Ads Campaign Management API provides functionalities for Moloco Ads Campaigns.",
    "version": "1.10",
    "contact": {
      "name": "Moloco Inc.",
      "url": "https://www.moloco.com"
    }
  },
  "paths": {
    "/cm/v1/tracking-links/{tracking_link_id}": {
      "put": {
        "summary": "Update an existing TrackingLink.",
        "description": "Update an existing TrackingLink.",
        "operationId": "DspApi_UpdateTrackingLink",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesUpdateTrackingLinkResponse"
                }
              }
            }
          },
          "default": {
            "description": "Error. Detailed cause can be found in the `details` field.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/messagesUpdateTrackingLinkError"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "tracking_link_id",
            "description": "The ID of the TrackingLink to be updated.",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/dspTrackingLink"
              }
            }
          },
          "description": "The updating TrackingLink data.",
          "required": true
        },
        "tags": [
          "TrackingLink"
        ]
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "servers": [
    {
      "url": "https://api.moloco.cloud"
    }
  ],
  "components": {
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "TrackingLinkUrlData": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "URL of the TrackingLink."
          },
          "status": {
            "$ref": "#/components/schemas/TrackingLinkUrlDataVerificationStatus",
            "description": "The verification status of the supplied URL.\nIt's managed by the Moloco servers and is readonly to the client.",
            "readOnly": true
          },
          "unverified_status_data": {
            "$ref": "#/components/schemas/UrlDataUnverifiedStatusData"
          },
          "verifying_status_data": {
            "$ref": "#/components/schemas/UrlDataVerifyingStatusData"
          },
          "verified_status_data": {
            "$ref": "#/components/schemas/UrlDataVerifiedStatusData"
          }
        },
        "required": [
          "url"
        ]
      },
      "TrackingLinkUrlDataVerificationStatus": {
        "type": "string",
        "enum": [
          "UNKNOWN_VERIFICATION_STATUS",
          "UNVERIFIED",
          "VERIFYING",
          "VERIFIED"
        ],
        "default": "UNKNOWN_VERIFICATION_STATUS",
        "description": "Enumeration of various TrackingLink verification status.\n\nThis value is not part of the specification.\n\n - UNVERIFIED: The TrackingLink is not yet verified.\n - VERIFYING: The TrackingLink is being verified.\n - VERIFIED: The TrackingLink has been verified."
      },
      "TrackingLinkVerificationAttemptUrlDataType": {
        "type": "string",
        "enum": [
          "UNKNOWN_URL_DATA_TYPE",
          "CT_LINK",
          "VT_LINK"
        ],
        "default": "UNKNOWN_URL_DATA_TYPE",
        "description": "The type of the UrlData that this attempt belongs to."
      },
      "UrlDataUnverifiedStatusData": {
        "type": "object",
        "properties": {
          "stored_at": {
            "type": "string",
            "format": "date-time",
            "description": "Creation time of this link."
          },
          "user_id": {
            "type": "string",
            "description": "The ID of the user who created this link."
          }
        },
        "description": "UnverifiedStatusData represents the information that the link is statically checked,\nbut has not been verified with the MMP integration."
      },
      "UrlDataVerifiedStatusData": {
        "type": "object",
        "properties": {
          "verified_attempt": {
            "$ref": "#/components/schemas/dspTrackingLinkVerificationAttempt",
            "description": "The attempt that has verified the link."
          }
        },
        "description": "VerifiedStatusData represents the information of the completed verification."
      },
      "UrlDataVerifyingStatusData": {
        "type": "object",
        "properties": {
          "attempt_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Each of ID refers to a TrackingLinkVerificationAttempt."
          }
        },
        "description": "VerifyingStatusData represents the information that a resolved URL has been sent to the MMP,\nbut we have not received any postback yet. We stay at this state indefinitely until receiving a postback."
      },
      "adcloudcommonTrackingCompany": {
        "type": "string",
        "enum": [
          "UNKNOWN_TRACKING_COMPANY",
          "KOCHAVA",
          "ADJUST",
          "MAT",
          "MOLOCO_PIXEL",
          "APPSFLYER",
          "ADBRIX",
          "WEB",
          "GENERIC",
          "TRACKFNT",
          "AIRBRIDGE",
          "MOLOCO_E2E",
          "APSALAR",
          "BRANCH",
          "TENJIN",
          "SINGULAR",
          "ADBRIX_V2",
          "TRAFFICGUARD",
          "GAMELOFT",
          "SKADNETWORK",
          "MYTRACKER",
          "MOLOCO_RMP",
          "MOLOCO_PIXEL_V2",
          "JUSTTRACK",
          "SHOPEE",
          "KOCHAVA_FOR_PUBLISHER",
          "GAMESIGHT",
          "CAULY",
          "HASOFFER",
          "ADACTION",
          "CURATE"
        ],
        "default": "UNKNOWN_TRACKING_COMPANY",
        "description": "Enumeration for tracking companies supported by Moloco Ads.\n\n - WEB: Unnamed trackers\n - AIRBRIDGE: Moloco's e2e tracker (test purpose only)\n - KOCHAVA_FOR_PUBLISHER: Kochava's CTV to web event dedicated tracking company."
      },
      "commonDeviceOs": {
        "type": "string",
        "enum": [
          "UNKNOWN_DEVICE_OS",
          "ANDROID",
          "IOS",
          "VERSATILE",
          "MOBILE_WEB",
          "MACOS",
          "WINDOWS",
          "NEXT_VERSATILE"
        ],
        "default": "UNKNOWN_DEVICE_OS",
        "description": "Enumeration of device OS types supported by Moloco Ads.\n\nThis value is not part of the specification.\n\n - ANDROID: Android device OS.\n - IOS: iOS device OS.\n - VERSATILE: Product with multiple OSes.\nSpecifically for CTV.\n - MOBILE_WEB: OS for mobile web traffic.\n - MACOS: OS for MacOS traffic.\n - WINDOWS: OS for Windows traffic.\n - NEXT_VERSATILE: OS for Next web product."
      },
      "dspTrackingLink": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the TrackingLink. Automatically set by server on creation."
          },
          "ad_account_id": {
            "type": "string",
            "description": "The ID of the AdAccount the TrackingLink belongs to.",
            "readOnly": true
          },
          "product_id": {
            "type": "string",
            "description": "The ID of the Product the TrackingLink belongs to.",
            "readOnly": true
          },
          "title": {
            "type": "string",
            "description": "A descriptive name of the TrackingLink."
          },
          "description": {
            "type": "string",
            "description": "An optional description about the TrackingLink."
          },
          "device_os": {
            "$ref": "#/components/schemas/commonDeviceOs",
            "description": "Device OS for which this TrackingLink should be served."
          },
          "click_through_link": {
            "$ref": "#/components/schemas/TrackingLinkUrlData",
            "description": "Click-through landing page URL. This URL is usually provided by the tracking company."
          },
          "view_through_link": {
            "$ref": "#/components/schemas/TrackingLinkUrlData",
            "description": "View-through impression tracking URL. This URL is usually provided by the tracking company."
          },
          "ctv_adjust_dual_vt_link": {
            "$ref": "#/components/schemas/TrackingLinkUrlData",
            "title": "This is used only for DSP CTV with adjust supporting dual link solution in s2s manner"
          },
          "tracking_company": {
            "$ref": "#/components/schemas/adcloudcommonTrackingCompany",
            "description": "Tracking company (e.g., Appsflyer, MAT, and so on)."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Created time.",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last updated time. Should not modify on the client side."
          }
        },
        "description": "TrackingLink represents an AdAccount's configuration for.",
        "required": [
          "device_os",
          "click_through_link",
          "title"
        ]
      },
      "dspTrackingLinkVerificationAttempt": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The ID of the TrackingLinkVerificationAttempt."
          },
          "ad_account_id": {
            "type": "string",
            "description": "The AdAccount ID that this attempt belongs to."
          },
          "tracking_link_id": {
            "type": "string",
            "description": "The ID of the TrackingLink that this attempt belongs to."
          },
          "url_data_type": {
            "$ref": "#/components/schemas/TrackingLinkVerificationAttemptUrlDataType"
          },
          "user_id": {
            "type": "string",
            "description": "The ID of the user who is conducting the link verification."
          },
          "user_email": {
            "type": "string",
            "description": "The user's email."
          },
          "user_name": {
            "type": "string",
            "description": "The user's name."
          },
          "tracking_bundle_id": {
            "type": "string",
            "description": "The tracking bundle value appears at the postback event."
          },
          "resolved_url": {
            "type": "string",
            "description": "The URL sent to the MMP for the verification test.\nThis is the macro expansion result of the original link URL."
          },
          "resolved_idfa": {
            "type": "string",
            "description": "The IDFA value used to generate the resolved_url."
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "description": "The starting time of the verification."
          },
          "verified_at": {
            "type": "string",
            "format": "date-time",
            "description": "The time when the verification test is completed."
          }
        },
        "description": "TrackingLinkVerificationAttempt represents an attempt to verify a TrackingLink."
      },
      "messagesTrackingLinkValidationStatus": {
        "type": "string",
        "enum": [
          "TRACKING_LINK_VALIDATION_STATUS_UNKNOWN",
          "TRACKING_LINK_VALIDATION_STATUS_SUCCESS",
          "TRACKING_LINK_VALIDATION_STATUS_WARNING"
        ],
        "default": "TRACKING_LINK_VALIDATION_STATUS_UNKNOWN",
        "description": " - TRACKING_LINK_VALIDATION_STATUS_SUCCESS: Created TrackingLink does not have any warnings.\n - TRACKING_LINK_VALIDATION_STATUS_WARNING: Created TrackingLink has some warnings."
      },
      "messagesUpdateTrackingLinkError": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "details": {
            "type": "array",
            "items": {
              "type": "object",
              "$ref": "#/components/schemas/messagesUpdateTrackingLinkErrorAPIErrorInfo"
            }
          }
        }
      },
      "messagesUpdateTrackingLinkErrorAPIErrorInfo": {
        "type": "object",
        "properties": {
          "reason": {
            "$ref": "#/components/schemas/messagesUpdateTrackingLinkErrorAPIErrorInfoErrorReason"
          },
          "error_log_id": {
            "type": "string"
          },
          "context": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      },
      "messagesUpdateTrackingLinkErrorAPIErrorInfoErrorReason": {
        "type": "string",
        "enum": [
          "ERROR_REASON_UNKNOWN",
          "TRACKING_LINK_INVALID_OS_TYPE"
        ],
        "default": "ERROR_REASON_UNKNOWN",
        "description": " - TRACKING_LINK_INVALID_OS_TYPE: The tracking link has invalid OS type."
      },
      "messagesUpdateTrackingLinkResponse": {
        "type": "object",
        "properties": {
          "tracking_link": {
            "$ref": "#/components/schemas/dspTrackingLink",
            "description": "The updated TrackingLink data."
          },
          "validation_status": {
            "$ref": "#/components/schemas/messagesTrackingLinkValidationStatus",
            "description": "The validation status of created tracking link.\nIf the status is WARNING, the tracking link has created but has not recommended values.\nPlease check the details using \"Validate a TrackingLink\" API."
          }
        }
      }
    }
  }
}
```