Productsup

Show how far a connector version is behind its branch

Compares the commit the image was built from against the current head of the configured branch. The answer is cached for a few minutes; pass force=true to check again immediately. Reading the branch head touches no disk, walking the missing commits clones the history and removes it again before answering.

Sign in to run requests against the CDE API.
GET
/connectors/{publicId}/versions/{connectorVersion}/vcs-drift

Authorization

oAuth2AuthCode
AuthorizationBearer <token>

In: header

Path Parameters

publicId*string
Formatuuid
connectorVersion*string

Major version number as an integer

  • For 1.0.5 use 1
  • For 2.5.6 use 2

You can also use latest for the latest version, or main for the currently main released version.

Match^main|latest|\d+$

Query Parameters

force?boolean

check the branch again instead of serving the answer kept from an earlier check

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://cde.staging.productsup.com/connectors/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions/string/vcs-drift"
{
  "message": "successful operation",
  "resource": "vcs-drift",
  "data": {
    "status": "up-to-date",
    "branch": "main",
    "latest-commit": "961579e1a33036ec50b842c7d19cec97403f6246",
    "remote-commit": "961579e1a33036ec50b842c7d19cec97403f6246",
    "commits-behind": 0,
    "commits-capped": false,
    "commits": [],
    "checked-at": "2026-10-06T07:55:53+02:00"
  }
}
{
  "message": "Vcs config must be set before drift can be checked.",
  "errors": []
}
{
  "message": "You have to be authorized to access this resource."
}
{
  "message": "Access denied for user."
}
{
  "message": "Connector does not have specified version."
}