v1

latestOpenAPI 3.0.3MIT2026-07-17241338.5 KB

External

Sync external binding

Triggers a synchronization of a named external binding (e.g. GitHub repository adapter). Reconciles local resource state against the external provider.

post/api/orgs/{org}/external/sync

Path parameters

orgstring required

Example:default

Organization slug

Request body

bindingNamestring

Name of the TransportBinding to sync

kindstring required

Resource kind being synced

localNamestring required

Local resource name

namespacestring

Kubernetes namespace (defaults to org namespace)

specobject

Local resource spec

watermarkstring

Sync watermark for incremental syncs

Example request

{
  "bindingName": "github-binding",
  "kind": "Repository",
  "localName": "my-repo",
  "externalEnvelope": {
    "nativeId": "123456",
    "url": "https://github.com/org/repo",
    "providerRef": "github"
  }
}

Response

Sync result

syncedboolean

conflictsobject[]

Example response

{
  "resource": {
    "apiVersion": "kradle.a5c.ai/v1alpha1",
    "kind": "AgentStack",
    "metadata": {
      "name": "my-stack",
      "namespace": "kradle-org-default"
    }
  }
}