Productsup
CDE APIApi referenceStates

Fetch the connector version last state id for specific action

A state is only accessible to an admin or the owner of the entity

Sign in to run requests against the CDE API.
GET
/connectors/{publicId}/versions/{connectorVersion}/states/{backgroundAction}

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+$
backgroundAction*string
Formatstring

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://loading/connectors/497f6eca-6276-4993-bfeb-53cbbbba6f08/versions/string/states/string"
{
  "message": "successful operation",
  "resource": "connector",
  "data": {
    "id": "019e6e76-48c9-7ea4-bb61-0c080ec9ee6f",
    "status": "pending",
    "name": "update_to_docker_wrapper_version",
    "owner": "019e6e76-48bb-7c7c-b6ed-7fb8cc3671a5",
    "created": "2026-05-28T14:01:46+02:00",
    "config": {
      "connectorPublicId": "019e6e76-48bd-7ae1-9365-ececaf1d05af",
      "majorVersion": 1
    },
    "data": []
  }
}
{
  "message": "This background action does not exist.",
  "errors": []
}
{
  "message": "Access denied for user."
}
{
  "message": "Last state was not found based on query parameters."
}

How is this guide?