Skip to content
CantoraAPI documentation
GET
/v1/organizations/{organizationId}/integrations/{integrationId}/versions

List an Integration's immutable Versions

Return a bounded page of published Versions in ascending revision order.

Authentication

Send an API key as a Bearer token in the Authorization header.

Parameters

NameLocationRequiredDescription
organizationIdpathYes
The Organization to address.
stringA Cantora Organization identifier, prefixed with `org_`.
  • maximum length 64
  • pattern ^org_[\s\S]+$
integrationIdpathYes
The stable Integration lineage to address.
stringA Cantora Integration identifier, prefixed with `integration_`.
  • maximum length 64
  • pattern ^integration_[\s\S]+$
cursorqueryNo
The opaque continuation token returned by the preceding page.
string
  • maximum length 2048
  • minimum length 1
  • pattern ^[A-Za-z0-9_-]+$
limitqueryNo
The maximum number of resources to return, from 1 through 100.
string
  • pattern ^[+-]?\d*\.?\d+(?:[Ee][+-]?\d+)?$

Responses

200DataIntegrationVersionPage
application/json
DataIntegrationVersionPageEncoded
400The request path, headers, query, or JSON body did not satisfy the published schema
401Unauthorized
application/json
UnauthorizedEncoded
403Forbidden
application/json
ForbiddenEncoded
404NotFound
application/json
NotFoundEncoded

Reusable schemas

DataIntegrationVersionPageEncoded

object
  • unknown properties allowed false
itemsrequired
arrayThe resources in this page, in stable order.
Items
DataIntegrationVersionSummaryEncoded
nextCursorrequired
The opaque continuation token for the next page, or null after the final page.
Any of
string
  • maximum length 2048
  • minimum length 1
  • pattern ^[A-Za-z0-9_-]+$
null

UnauthorizedEncoded

object
  • unknown properties allowed false
_tagrequired
stringThe stable machine-readable error type.
  • allowed values "Unauthorized"
reasonrequired
stringA safe explanation of why the credential was rejected.

ForbiddenEncoded

object
  • unknown properties allowed false
_tagrequired
stringThe stable machine-readable error type.
  • allowed values "Forbidden"
permissionrequired
stringThe permission required by the refused operation.

NotFoundEncoded

object
  • unknown properties allowed false
_tagrequired
stringThe stable machine-readable error type.
  • allowed values "NotFound"
resourcerequired
stringThe resource type relevant to the error.
idrequired
stringThe identifier supplied for the resource that was not found.

DataIntegrationVersionSummaryEncoded

object
  • unknown properties allowed false
integrationVersionIdrequired
stringThe immutable Integration Version identifier.
  • maximum length 64
  • pattern ^integration_version_[\s\S]+$
organizationIdrequired
stringThe Organization identifier.
  • maximum length 64
  • pattern ^org_[\s\S]+$
integrationIdrequired
stringThe stable Organization-scoped Integration identifier.
  • maximum length 64
  • pattern ^integration_[\s\S]+$
revisionrequired
integerThe monotonically increasing revision within the Agent Definition.
  • greater than 0
manifestDigestrequired
stringThe lowercase SHA-256 digest of the normalized manifest.
  • maximum length 64
  • minimum length 64
  • pattern ^[0-9a-f]{64}$
createdByPrincipalIdrequired
stringThe Principal that created this immutable record.
  • maximum length 64
  • pattern ^principal_[\s\S]+$
sourcerequired
DataIntegrationVersionSourceThe source revision and automation provenance.
createdAtrequired
stringWhen the resource was created, in UTC.
  • format date-time

DataIntegrationVersionSource

object
  • unknown properties allowed false
repositoryrequired
stringThe source repository identifier.
  • maximum length 500
  • minimum length 1
commitrequired
stringThe immutable source revision.
  • maximum length 500
  • minimum length 1
pathrequired
stringThe path within the source repository.
  • maximum length 500
  • minimum length 1
workflowrequired
stringThe source automation workflow identifier.
  • maximum length 500
  • minimum length 1
runrequired
stringThe source automation run identifier.
  • maximum length 500
  • minimum length 1