@epilot/sdk 2.19.3 → 2.19.4

package/definitions/configuration-hub.json

@@ -0,0 +1,2250 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Configuration Hub API",
+    "description": "Lightweight index API for exploring epilot organization configurations.\n\nProvides a unified tree view across all config types. Returns summary metadata only —\nthe frontend calls individual epilot APIs directly (via @epilot/sdk) for full config payloads.\n\n## Source APIs per resource type\n\nEach resource type maps to a specific epilot API. The frontend should use the corresponding\n@epilot/sdk client to fetch full config details (e.g., for the side panel JSON view).\n\n| Resource Type | Source API | SDK Client |\n|---|---|---|\n| `journey` | journey.sls.epilot.io | `@epilot/sdk/journey` |\n| `automation_flow` | automation.sls.epilot.io | `@epilot/sdk/automation` |\n| `workflow_definition` | workflow-definition.sls.epilot.io | `@epilot/sdk/workflow-definition` |\n| `closing_reason` | workflow-definition.sls.epilot.io | `@epilot/sdk/workflow-definition` |\n| `flow_template` | workflow-definition.sls.epilot.io | `@epilot/sdk/workflow-definition` |\n| `schema` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `taxonomy` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `taxonomy_classification` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `emailtemplate` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `product` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `price` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `tax` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `coupon` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `file` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `document_template` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `webhook` | webhooks.sls.epilot.io | `@epilot/sdk/webhooks` |\n| `saved_view` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `dashboard` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `kanban` | kanban.sls.epilot.io | `@epilot/sdk/kanban` |\n| `role` | permissions.sls.epilot.io | `@epilot/sdk/permissions` |\n| `usergroup` | user.sls.epilot.io | `@epilot/sdk/user` |\n| `validation_rule` | entity.sls.epilot.io | `@epilot/sdk/validation-rules` |\n| `integration` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `app` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `designbuilder` | design-builder-api.sls.epilot.io | `@epilot/sdk/design` |\n| `notification_template` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `custom_variable` | entity.sls.epilot.io | `@epilot/sdk/template-variables` |\n| `environment_variable` | environments.sls.epilot.io | `@epilot/sdk/environments` |\n| `entity_mapping` | entity-mapping.sls.epilot.io | `@epilot/sdk/entity-mapping` |\n| `portal_config` | customer-portal.sls.epilot.io | `@epilot/sdk/customer-portal` |\n| `target` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `product_recommendation` | entity.sls.epilot.io | `@epilot/sdk/entity` |\n| `access_token` | access-token.sls.epilot.io | `@epilot/sdk/access-token` |\n",
+    "version": "0.2.0"
+  },
+  "servers": [
+    {
+      "url": "https://configuration-hub.sls.epilot.io"
+    },
+    {
+      "url": "https://configuration-hub.dev.sls.epilot.io",
+      "description": "Dev"
+    }
+  ],
+  "security": [
+    {
+      "EpilotAuth": []
+    }
+  ],
+  "tags": [
+    {
+      "name": "Configs",
+      "description": "Configuration tree index"
+    },
+    {
+      "name": "Sync",
+      "description": "Cross-org configuration sync jobs"
+    },
+    {
+      "name": "Delete",
+      "description": "Bulk-delete jobs for configuration resources"
+    },
+    {
+      "name": "Compare",
+      "description": "Cross-org configuration comparison, match suggestions, and lineage operations"
+    }
+  ],
+  "paths": {
+    "/v1/configs/types": {
+      "get": {
+        "operationId": "listConfigTypes",
+        "summary": "listConfigTypes",
+        "description": "Returns the static list of available configuration types with display metadata.\nThis is a cheap call — no fan-out to downstream APIs. Returns all known types\nwith labels and icons. The frontend should then call `listConfigs` separately\nfor each type it wants to load.\n",
+        "tags": [
+          "Configs"
+        ],
+        "responses": {
+          "200": {
+            "description": "Available config types",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "results": {
+                      "type": "array",
+                      "items": {
+                        "$ref": "#/components/schemas/ConfigTypeInfo"
+                      }
+                    }
+                  },
+                  "required": [
+                    "results"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/{type}": {
+      "get": {
+        "operationId": "listConfigs",
+        "summary": "listConfigs",
+        "description": "List configs of a given type with pagination. Returns summary metadata only\n(not full payloads). The frontend calls this per type folder when expanding.\n\nSupports offset-based pagination via `from` and `size` parameters.\n",
+        "tags": [
+          "Configs"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ConfigType"
+          },
+          {
+            "$ref": "#/components/parameters/CursorParam"
+          },
+          {
+            "$ref": "#/components/parameters/SizeParam"
+          },
+          {
+            "name": "q",
+            "in": "query",
+            "description": "Search query to filter configs by name/title",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "updated_after",
+            "in": "query",
+            "description": "Filter configs updated after this date (ISO 8601)",
+            "schema": {
+              "type": "string",
+              "format": "date-time"
+            }
+          },
+          {
+            "name": "updated_before",
+            "in": "query",
+            "description": "Filter configs updated before this date (ISO 8601)",
+            "schema": {
+              "type": "string",
+              "format": "date-time"
+            }
+          },
+          {
+            "name": "purposes",
+            "in": "query",
+            "description": "Filter by purpose classification IDs (comma-separated)",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "blueprint_ids",
+            "in": "query",
+            "description": "Filter by installed-blueprint IDs (comma-separated). Only configs installed by one of the listed blueprints are returned.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "description": "Sort order. `updated_at` (default) sorts by most recently modified.\n`usage` sorts by the type-specific usage metric descending\n(submissions for journeys, executions for automations, entities for schemas, etc.).\n`name` sorts alphabetically by title (A–Z, case-insensitive).\n",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "updated_at",
+                "usage",
+                "name"
+              ],
+              "default": "updated_at"
+            }
+          },
+          {
+            "name": "active_only",
+            "in": "query",
+            "description": "If true, filter out configs that are explicitly inactive (active=false).\nConfigs with no `active` field are always included.\n",
+            "schema": {
+              "type": "boolean"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated config list",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ConfigListResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid config type",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/{type}/{id}/dependencies": {
+      "get": {
+        "operationId": "getConfigDependencies",
+        "summary": "getConfigDependencies",
+        "description": "Get configs that are referenced by the given config.\nUsed to render children when expanding a config node in the tree.\n\nResolves dependencies by fetching the config payload server-side and scanning\nfor references (UUIDs, source IDs, slug-based references).\n",
+        "tags": [
+          "Configs"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ConfigType"
+          },
+          {
+            "$ref": "#/components/parameters/ConfigId"
+          },
+          {
+            "$ref": "#/components/parameters/CursorParam"
+          },
+          {
+            "$ref": "#/components/parameters/SizeParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated list of referenced configs",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ConfigDependenciesResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Config not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/{type}/{id}/used_by": {
+      "get": {
+        "operationId": "getConfigUsedBy",
+        "summary": "getConfigUsedBy",
+        "description": "Get configs that reference the given config (reverse dependencies).\nScans the indexed config items for references to this config's ID or aliases.\n",
+        "tags": [
+          "Configs"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/ConfigType"
+          },
+          {
+            "$ref": "#/components/parameters/ConfigId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of configs that reference this config",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ConfigDependenciesResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/index": {
+      "get": {
+        "operationId": "getIndex",
+        "summary": "getIndex",
+        "description": "Return the current index build state for the caller's organization.\nClients poll this to decide whether to show a \"building\" indicator\nand when to refetch data.\n",
+        "tags": [
+          "Configs"
+        ],
+        "responses": {
+          "200": {
+            "description": "Current index status",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/IndexStatusResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/compare": {
+      "post": {
+        "operationId": "compareConfigs",
+        "summary": "compareConfigs",
+        "description": "Compare the caller org's configs of a single type against another\n(source) org, side by side. Rows are paired via the lineage registry in\nboth sync directions (caller imported from source, or source imported\nfrom caller); configs without a counterpart come back as `only_current`\nor `only_source`.\n\n`source_auth_token` must be a valid token for `source_org_id` — the\nfrontend mints one via the pipeline pairing, mirroring `createSyncJob`'s\n`target_auth_token`. The token is verified against `source_org_id`\nbefore any source-org data is read.\n\nPOST because the request carries a token; the operation reads only.\n",
+        "tags": [
+          "Compare"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CompareRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Side-by-side comparison rows for the requested type",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CompareResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Unknown type or comparing an org with itself",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "source_auth_token does not belong to source_org_id",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/compare/suggestions": {
+      "post": {
+        "operationId": "suggestMatches",
+        "summary": "suggestMatches",
+        "description": "Run the sync-grade heuristic match (`lookupByHeuristic` — name / slug /\nunique key) for a batch of source-org configs that have no lineage\nentry, and return candidate counterparts in the caller's org.\n\nSuggestions are ephemeral — nothing is persisted. The client offers\neach candidate to the user, and a confirmed pair is written via\n`confirmLineage`. Batches are capped at 25 ids; the client pages\nthrough unmatched rows across successive calls.\n",
+        "tags": [
+          "Compare"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SuggestMatchesRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Heuristic match candidates per source id",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SuggestMatchesResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Unknown type or type without heuristic support",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/lineage": {
+      "post": {
+        "operationId": "confirmLineage",
+        "summary": "confirmLineage",
+        "description": "Persist a lineage entry pairing a source-org config with a config in\nthe caller's org — used to confirm a heuristic suggestion from the\nCompare view. Writes to the caller org's lineage partition (caller as\nsync target), so subsequent syncs PATCH the confirmed target instead of\ncreating a duplicate. Conflicts (an existing entry pointing at a\ndifferent target) return 409 so the client can refresh.\n",
+        "tags": [
+          "Compare"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ConfirmLineageRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Lineage entry persisted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LineageEntryResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Unknown type or target config not found in caller org",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A lineage entry for this source config already points at a different target",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "operationId": "breakLineage",
+        "summary": "breakLineage",
+        "description": "Delete a lineage entry from the caller org's partition (caller as sync\ntarget), identified by `type` + `source_id`. Used to break a wrong or\nstale match from the Compare view. Note: a future sync can re-match the\nsame pair heuristically — the entry is deleted, not blocklisted. To\nbreak a match recorded in the OTHER direction, call this operation\nauthenticated as the other org (pipeline token).\n",
+        "tags": [
+          "Compare"
+        ],
+        "parameters": [
+          {
+            "name": "type",
+            "in": "query",
+            "required": true,
+            "description": "Configuration resource type of the lineage entry",
+            "schema": {
+              "$ref": "#/components/schemas/ResourceType"
+            }
+          },
+          {
+            "name": "source_id",
+            "in": "query",
+            "required": true,
+            "description": "Source-org config id the lineage entry is keyed by",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Lineage entry deleted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BreakLineageResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No lineage entry found for this type + source_id",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/sync-jobs": {
+      "post": {
+        "operationId": "createSyncJob",
+        "summary": "createSyncJob",
+        "description": "Create a new cross-org sync job. The job is enqueued for asynchronous execution\nby the worker Lambda; the response returns the persisted job header with status\n`pending`.\n\nSee `docs/sync/INTERFACES.md` for the locked request/response contract.\n",
+        "tags": [
+          "Sync"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SyncJobRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Sync job accepted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SyncJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request body",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "listSyncJobs",
+        "summary": "listSyncJobs",
+        "description": "List sync jobs scoped to the caller's organization, paginated with an opaque\ncursor. Defaults to most-recent first.\n",
+        "tags": [
+          "Sync"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/CursorParam"
+          },
+          {
+            "$ref": "#/components/parameters/SizeParam"
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Filter jobs by status",
+            "schema": {
+              "$ref": "#/components/schemas/SyncJobStatus"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated sync jobs",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SyncJobListResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/sync-jobs/{id}": {
+      "get": {
+        "operationId": "getSyncJob",
+        "summary": "getSyncJob",
+        "description": "Fetch a single sync job by ID. Returns the job header, counts summary,\ncurrent phase pointer, and the latest activity events. Frontend polls this\nendpoint with a ramping interval.\n",
+        "tags": [
+          "Sync"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/SyncJobId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Sync job detail",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SyncJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Sync job not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/sync-jobs/{id}/retry": {
+      "post": {
+        "operationId": "retrySyncJob",
+        "summary": "retrySyncJob",
+        "description": "Retry the unresolved resources from a prior sync job: `failed` rows, plus\nrows the original run left at `pending`/`in_progress` because it stopped\nearly. Creates a new job whose scope is that `(type, source_id)` set and\nenqueues it for execution. Optionally accepts inline payload overrides.\n",
+        "tags": [
+          "Sync"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/SyncJobId"
+          }
+        ],
+        "requestBody": {
+          "required": false,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SyncJobRetryRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Retry job accepted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SyncJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Sync job not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/sync-jobs/{id}/cancel": {
+      "post": {
+        "operationId": "cancelSyncJob",
+        "summary": "cancelSyncJob",
+        "description": "Cancel a running sync job. Marks the job `cancelled` with a `finished_at`\nso it stops being reported as in-flight, and the worker stops at its next\nbatch boundary — phases re-read the job status and abort rather than\noverwrite a cancellation with their own outcome.\n\nResources already written to the target are NOT rolled back; cancelling\nstops further work. Jobs already in a terminal state are rejected with\n409.\n",
+        "tags": [
+          "Sync"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/SyncJobId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Job cancelled",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SyncJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Sync job not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Job already finished",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/sync-jobs/{id}/resources": {
+      "get": {
+        "operationId": "listSyncJobResources",
+        "summary": "listSyncJobResources",
+        "description": "List the per-resource rows for a sync job. Supports filtering by status\n(e.g. `failed`) and cursor pagination. Used by the failures table and the\ndry-run plan view in the frontend.\n",
+        "tags": [
+          "Sync"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/SyncJobId"
+          },
+          {
+            "$ref": "#/components/parameters/CursorParam"
+          },
+          {
+            "$ref": "#/components/parameters/SizeParam"
+          },
+          {
+            "name": "status",
+            "in": "query",
+            "description": "Filter resources by status",
+            "schema": {
+              "$ref": "#/components/schemas/SyncJobResourceStatus"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated sync job resources",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SyncJobResourceListResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Sync job not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/delete-jobs": {
+      "post": {
+        "operationId": "createDeleteJob",
+        "summary": "createDeleteJob",
+        "description": "Create a bulk-delete job for the caller's organization. The selected\nresources are deleted asynchronously by a worker Lambda; the response\nreturns the persisted job header with status `pending`.\n\nRaw delete — no dependency checks are performed. On completion the\nworker auto-triggers an index rebuild so the config list reflects the\ndeletions.\n",
+        "tags": [
+          "Delete"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DeleteJobRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Delete job accepted",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteJob"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request body",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      },
+      "get": {
+        "operationId": "listDeleteJobs",
+        "summary": "listDeleteJobs",
+        "description": "List bulk-delete jobs scoped to the caller's organization, paginated\nwith an opaque cursor. Most-recent first.\n",
+        "tags": [
+          "Delete"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/CursorParam"
+          },
+          {
+            "$ref": "#/components/parameters/SizeParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated delete jobs",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteJobListResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/delete-jobs/{id}": {
+      "get": {
+        "operationId": "getDeleteJob",
+        "summary": "getDeleteJob",
+        "description": "Fetch a single bulk-delete job by ID. Returns the job header and counts\nsummary. Frontend polls this endpoint while the job runs.\n",
+        "tags": [
+          "Delete"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/DeleteJobId"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Delete job detail",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteJob"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Delete job not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/delete-jobs/{id}/resources": {
+      "get": {
+        "operationId": "listDeleteJobResources",
+        "summary": "listDeleteJobResources",
+        "description": "List the per-resource rows for a delete job, cursor-paginated. Used by\nthe failures view in the frontend.\n",
+        "tags": [
+          "Delete"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/DeleteJobId"
+          },
+          {
+            "$ref": "#/components/parameters/CursorParam"
+          },
+          {
+            "$ref": "#/components/parameters/SizeParam"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Paginated delete job resources",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DeleteJobResourceListResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Delete job not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/index:rebuild": {
+      "post": {
+        "operationId": "rebuildIndex",
+        "summary": "rebuildIndex",
+        "description": "Rebuild the configuration index for the caller's organization.\nFire-and-forget: invokes the async worker and returns immediately.\nA new rebuild will cancel any in-flight build (see `build_token`).\n",
+        "tags": [
+          "Configs"
+        ],
+        "responses": {
+          "200": {
+            "description": "Index build status",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/IndexRebuildResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/configs/inventory": {
+      "get": {
+        "operationId": "getConfigInventory",
+        "summary": "getConfigInventory",
+        "description": "Returns a fresh inventory of an org's configuration resources — `{ type, id }` identities only,\nno full payloads. Calls every adapter's `list()` live (bypasses the 7-day DynamoDB index).\nIntended for snapshot-api to consume when taking a full-org snapshot.\n",
+        "tags": [
+          "Configs"
+        ],
+        "parameters": [
+          {
+            "name": "include_dependency_only",
+            "in": "query",
+            "description": "When true (default), include dependency-only types (e.g. `entity_mapping`)\nin the inventory in addition to the top-level registered types.\n",
+            "schema": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Fresh inventory of all org configuration resources",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ConfigInventoryResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "securitySchemes": {
+      "EpilotAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "description": "epilot JWT auth token"
+      }
+    },
+    "parameters": {
+      "ConfigType": {
+        "name": "type",
+        "in": "path",
+        "required": true,
+        "description": "Configuration resource type",
+        "schema": {
+          "$ref": "#/components/schemas/ResourceType"
+        }
+      },
+      "ConfigId": {
+        "name": "id",
+        "in": "path",
+        "required": true,
+        "description": "Configuration resource ID",
+        "schema": {
+          "type": "string"
+        }
+      },
+      "CursorParam": {
+        "name": "cursor",
+        "in": "query",
+        "description": "Opaque cursor for fetching the next page. Omit for the first page.",
+        "schema": {
+          "type": "string"
+        }
+      },
+      "SizeParam": {
+        "name": "size",
+        "in": "query",
+        "description": "Number of items per page",
+        "schema": {
+          "type": "integer",
+          "default": 25,
+          "minimum": 1,
+          "maximum": 100
+        }
+      },
+      "SyncJobId": {
+        "name": "id",
+        "in": "path",
+        "required": true,
+        "description": "Sync job ID",
+        "schema": {
+          "type": "string"
+        }
+      },
+      "DeleteJobId": {
+        "name": "id",
+        "in": "path",
+        "required": true,
+        "description": "Delete job ID",
+        "schema": {
+          "type": "string"
+        }
+      }
+    },
+    "schemas": {
+      "ResourceType": {
+        "type": "string",
+        "description": "Configuration resource type identifier.\nMatches blueprint-manifest-api V3 naming conventions.\n",
+        "enum": [
+          "journey",
+          "automation_flow",
+          "workflow_definition",
+          "closing_reason",
+          "flow_template",
+          "schema",
+          "emailtemplate",
+          "product",
+          "price",
+          "tax",
+          "coupon",
+          "file",
+          "document_template",
+          "webhook",
+          "saved_view",
+          "dashboard",
+          "kanban",
+          "role",
+          "usergroup",
+          "validation_rule",
+          "integration",
+          "app",
+          "designbuilder",
+          "notification_template",
+          "custom_variable",
+          "environment_variable",
+          "taxonomy",
+          "taxonomy_classification",
+          "entity_mapping",
+          "portal_config",
+          "target",
+          "product_recommendation",
+          "access_token"
+        ]
+      },
+      "ConfigTypeInfo": {
+        "type": "object",
+        "description": "Static metadata for a config type folder in the tree.\nNo downstream API calls — just type + label + icon + source API info.\n",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "label": {
+            "type": "string",
+            "description": "Display label",
+            "example": "Journeys"
+          },
+          "icon": {
+            "type": "string",
+            "description": "Frontend icon name",
+            "example": "Route"
+          },
+          "source_api": {
+            "type": "string",
+            "description": "Base URL of the epilot API that owns this resource type",
+            "example": "https://journey.sls.epilot.io"
+          },
+          "sdk_client": {
+            "type": "string",
+            "description": "@epilot/sdk subpath for fetching full config payloads",
+            "example": "@epilot/sdk/journey"
+          },
+          "deletable": {
+            "type": "boolean",
+            "description": "Whether resources of this type can be deleted via the bulk-delete API",
+            "example": true
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "icon",
+          "source_api",
+          "sdk_client",
+          "deletable"
+        ]
+      },
+      "ConfigNode": {
+        "type": "object",
+        "description": "Summary metadata for a single configuration item in the tree",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "id": {
+            "type": "string",
+            "description": "Unique identifier"
+          },
+          "title": {
+            "type": "string",
+            "description": "Display name"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Last modified timestamp"
+          },
+          "updated_by": {
+            "type": "string",
+            "description": "User who last modified this config"
+          },
+          "tags": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Tags / labels"
+          },
+          "aliases": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Alternative identifiers (short IDs, slugs, variable keys) used in cross-references"
+          },
+          "purposes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Business purposes"
+          },
+          "link": {
+            "type": "string",
+            "format": "uri",
+            "description": "Direct link to open this config in epilot"
+          },
+          "active": {
+            "type": "boolean",
+            "description": "Whether this config is currently active/enabled (omitted when not applicable)"
+          },
+          "blueprints": {
+            "type": "array",
+            "description": "Installed blueprints that produced this config (tagged during the rebuild lineage pass)",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id",
+                "title"
+              ]
+            }
+          },
+          "metadata": {
+            "type": "object",
+            "description": "Type-specific metadata (e.g., submission count for journeys)",
+            "additionalProperties": true
+          }
+        },
+        "required": [
+          "type",
+          "id",
+          "title"
+        ]
+      },
+      "ConfigListResponse": {
+        "type": "object",
+        "description": "Cursor-paginated list of configs for a specific type",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "label": {
+            "type": "string"
+          },
+          "icon": {
+            "type": "string"
+          },
+          "total": {
+            "type": "integer",
+            "description": "Total number of configs of this type (if known)"
+          },
+          "next_cursor": {
+            "type": "string",
+            "description": "Cursor for fetching the next page. Absent when no more pages."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ConfigNode"
+            }
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "icon",
+          "results"
+        ]
+      },
+      "ConfigDependenciesResponse": {
+        "type": "object",
+        "description": "Cursor-paginated list of configs referenced by a given config",
+        "properties": {
+          "total": {
+            "type": "integer",
+            "description": "Total number of dependencies found (if known)"
+          },
+          "next_cursor": {
+            "type": "string",
+            "description": "Cursor for fetching the next page. Absent when no more pages."
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ConfigNode"
+            }
+          }
+        },
+        "required": [
+          "results"
+        ]
+      },
+      "IndexRebuildResponse": {
+        "type": "object",
+        "description": "Result of an index rebuild operation",
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "ready",
+              "building",
+              "failed",
+              "already_building"
+            ]
+          },
+          "last_built_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "build_duration_ms": {
+            "type": "integer"
+          },
+          "failed_types": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "IndexStatusResponse": {
+        "type": "object",
+        "description": "Current index build state",
+        "properties": {
+          "status": {
+            "type": "string",
+            "enum": [
+              "missing",
+              "building",
+              "ready",
+              "failed"
+            ]
+          },
+          "org_id": {
+            "type": "string",
+            "description": "Organization the index (and the authenticated token) belongs to.\nEchoed so callers holding a token for another org can resolve and\nverify its identity.\n"
+          },
+          "last_built_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "build_duration_ms": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "status"
+        ]
+      },
+      "CompareRequest": {
+        "type": "object",
+        "description": "Request body for a per-type cross-org comparison",
+        "properties": {
+          "source_org_id": {
+            "type": "string",
+            "description": "Organization to compare the caller's org against"
+          },
+          "source_auth_token": {
+            "type": "string",
+            "description": "Auth token belonging to `source_org_id` (e.g. a pipeline token).\nVerified before any source-org data is read. Never logged.\n"
+          },
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          }
+        },
+        "required": [
+          "source_org_id",
+          "source_auth_token",
+          "type"
+        ]
+      },
+      "CompareLineage": {
+        "type": "object",
+        "description": "Provenance of a lineage-backed match",
+        "properties": {
+          "direction": {
+            "type": "string",
+            "enum": [
+              "pull",
+              "push"
+            ],
+            "description": "`pull` — the caller org imported this config from the source org\n(entry lives in the caller's lineage partition). `push` — the\nsource org imported it from the caller (entry lives in the source\norg's partition).\n"
+          },
+          "last_synced_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "last_sync_job_id": {
+            "type": "string"
+          },
+          "origin": {
+            "type": "string",
+            "description": "`manual_confirm` when the entry was created by confirming a\nheuristic suggestion in the Compare view; absent for sync-written\nentries.\n"
+          }
+        },
+        "required": [
+          "direction"
+        ]
+      },
+      "CompareRow": {
+        "type": "object",
+        "description": "One row of the side-by-side comparison. `matched` rows carry both\nconfigs plus lineage provenance; one-sided rows carry only the side\nthe config exists on.\n",
+        "properties": {
+          "match_status": {
+            "type": "string",
+            "enum": [
+              "matched",
+              "only_current",
+              "only_source"
+            ]
+          },
+          "current": {
+            "$ref": "#/components/schemas/ConfigNode"
+          },
+          "source": {
+            "$ref": "#/components/schemas/ConfigNode"
+          },
+          "lineage": {
+            "$ref": "#/components/schemas/CompareLineage"
+          }
+        },
+        "required": [
+          "match_status"
+        ]
+      },
+      "CompareCounts": {
+        "type": "object",
+        "description": "Row counts per match status",
+        "properties": {
+          "matched": {
+            "type": "integer"
+          },
+          "only_current": {
+            "type": "integer"
+          },
+          "only_source": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "matched",
+          "only_current",
+          "only_source"
+        ]
+      },
+      "CompareResponse": {
+        "type": "object",
+        "description": "Side-by-side comparison of one config type across two orgs",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "label": {
+            "type": "string"
+          },
+          "icon": {
+            "type": "string"
+          },
+          "rows": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/CompareRow"
+            }
+          },
+          "counts": {
+            "$ref": "#/components/schemas/CompareCounts"
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "icon",
+          "rows",
+          "counts"
+        ]
+      },
+      "SuggestMatchesRequest": {
+        "type": "object",
+        "description": "Request body for batched heuristic match suggestions",
+        "properties": {
+          "source_org_id": {
+            "type": "string"
+          },
+          "source_auth_token": {
+            "type": "string",
+            "description": "Auth token belonging to `source_org_id`. Never logged."
+          },
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "source_ids": {
+            "type": "array",
+            "description": "Source-org config ids to find caller-org candidates for",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1,
+            "maxItems": 25
+          }
+        },
+        "required": [
+          "source_org_id",
+          "source_auth_token",
+          "type",
+          "source_ids"
+        ]
+      },
+      "MatchSuggestion": {
+        "type": "object",
+        "description": "Heuristic candidate for one source config (null candidate = no match)",
+        "properties": {
+          "source_id": {
+            "type": "string"
+          },
+          "candidate": {
+            "type": "object",
+            "nullable": true,
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "title": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "id"
+            ]
+          }
+        },
+        "required": [
+          "source_id"
+        ]
+      },
+      "SuggestMatchesResponse": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "suggestions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/MatchSuggestion"
+            }
+          }
+        },
+        "required": [
+          "type",
+          "suggestions"
+        ]
+      },
+      "ConfirmLineageRequest": {
+        "type": "object",
+        "description": "Persist a source→target lineage pairing (caller org as target)",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "source_org_id": {
+            "type": "string"
+          },
+          "source_id": {
+            "type": "string",
+            "description": "Config id in the source org"
+          },
+          "target_id": {
+            "type": "string",
+            "description": "Config id in the caller's org to pair it with"
+          }
+        },
+        "required": [
+          "type",
+          "source_org_id",
+          "source_id",
+          "target_id"
+        ]
+      },
+      "LineageEntryResponse": {
+        "type": "object",
+        "description": "A persisted lineage entry",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "target_org_id": {
+            "type": "string"
+          },
+          "source_org_id": {
+            "type": "string"
+          },
+          "source_id": {
+            "type": "string"
+          },
+          "target_id": {
+            "type": "string"
+          },
+          "last_synced_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "origin": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "target_org_id",
+          "source_org_id",
+          "source_id",
+          "target_id"
+        ]
+      },
+      "BreakLineageResponse": {
+        "type": "object",
+        "properties": {
+          "deleted": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "deleted"
+        ]
+      },
+      "ErrorResponse": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "integer"
+          },
+          "error": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "status",
+          "error"
+        ]
+      },
+      "SyncJobStatus": {
+        "type": "string",
+        "description": "Lifecycle status of a sync job. See `docs/sync/INTERFACES.md` for state\ntransitions.\n",
+        "enum": [
+          "pending",
+          "in_progress",
+          "succeeded",
+          "partial",
+          "failed",
+          "cancelled"
+        ]
+      },
+      "SyncDirection": {
+        "type": "string",
+        "description": "Direction of the sync, derived from the source/target pane selection in the\nconfiguration hub UI.\n",
+        "enum": [
+          "push",
+          "pull"
+        ]
+      },
+      "SyncPhase": {
+        "type": "string",
+        "description": "Three-phase orchestrator phase. `phase_0` fetches source payloads,\n`phase_a` creates/matches with topological batches, `phase_a5` resolves\nderived references, `phase_b` patches with the full ID map, `finalize`\nruns cycle-breaking finalizers.\n",
+        "enum": [
+          "phase_0",
+          "phase_a",
+          "phase_a5",
+          "phase_b",
+          "finalize"
+        ]
+      },
+      "SyncJobResourceStatus": {
+        "type": "string",
+        "description": "Per-resource status. `would_*` values are produced by dry-run jobs.\n",
+        "enum": [
+          "pending",
+          "in_progress",
+          "created",
+          "patched",
+          "skipped",
+          "would_create",
+          "would_patch",
+          "would_skip_unchanged",
+          "would_match_heuristic",
+          "failed"
+        ]
+      },
+      "SyncJobRequest": {
+        "type": "object",
+        "description": "Request body for `createSyncJob`. `target_auth_token` is the destination\norg's auth token and MUST NOT be persisted or logged — it is `writeOnly`.\n",
+        "required": [
+          "source_org_id",
+          "target_org_id",
+          "target_auth_token",
+          "resources"
+        ],
+        "properties": {
+          "source_org_id": {
+            "type": "string",
+            "description": "Org ID the resources are sourced from."
+          },
+          "target_org_id": {
+            "type": "string",
+            "description": "Org ID the resources are written into."
+          },
+          "target_auth_token": {
+            "type": "string",
+            "writeOnly": true,
+            "description": "Destination-org auth token forwarded to adapter writes. Never returned\nin responses and never logged.\n"
+          },
+          "name": {
+            "type": "string",
+            "description": "Optional human-friendly job name shown in the history list."
+          },
+          "dry_run": {
+            "type": "boolean",
+            "default": false,
+            "description": "If true, the orchestrator runs Phase 0 + a planning pass and writes\n`would_*` resource rows but performs no destination writes.\n"
+          },
+          "include_dependencies": {
+            "type": "boolean",
+            "default": true,
+            "description": "If true, the orchestrator expands the resource set by following\ndependency edges discovered during Phase 0.\n"
+          },
+          "resources": {
+            "type": "array",
+            "description": "Initial resource selection. Dependencies may be added.",
+            "items": {
+              "type": "object",
+              "required": [
+                "type",
+                "id"
+              ],
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "description": "Resource type identifier"
+                },
+                "id": {
+                  "type": "string",
+                  "description": "Source-org resource ID"
+                }
+              }
+            }
+          }
+        }
+      },
+      "SyncJobRetryRequest": {
+        "type": "object",
+        "description": "Optional body for `retrySyncJob`. Defaults to retrying every unresolved\nresource of the original job (failed, pending or in_progress).\n",
+        "properties": {
+          "payload_overrides": {
+            "type": "object",
+            "description": "Map of `<type>:<source_id>` → partial payload patch. Applied on top of\nthe originally fetched payload before re-running Phase A.\n",
+            "additionalProperties": true
+          }
+        }
+      },
+      "SyncJobCounts": {
+        "type": "object",
+        "description": "Aggregate counters by resource status.",
+        "properties": {
+          "total": {
+            "type": "integer"
+          },
+          "pending": {
+            "type": "integer"
+          },
+          "in_progress": {
+            "type": "integer"
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "skipped_unchanged": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "total",
+          "pending",
+          "in_progress",
+          "succeeded",
+          "failed",
+          "skipped_unchanged"
+        ]
+      },
+      "SyncJobEvent": {
+        "type": "object",
+        "description": "Activity-log entry surfaced to the frontend. Backed by the op-log rows in\nthe index table (`SYNC#<jobId>#OP#<seq>`).\n",
+        "properties": {
+          "seq": {
+            "type": "integer",
+            "description": "Monotonic sequence number assigned at write time."
+          },
+          "ts": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "phase": {
+            "$ref": "#/components/schemas/SyncPhase"
+          },
+          "type": {
+            "type": "string",
+            "description": "Resource type"
+          },
+          "source_id": {
+            "type": "string"
+          },
+          "target_id": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/SyncJobResourceStatus"
+          },
+          "message": {
+            "type": "string"
+          },
+          "error": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "seq",
+          "ts",
+          "status"
+        ]
+      },
+      "SyncJobBatch": {
+        "type": "object",
+        "description": "Position within the current topological batch for the active phase.",
+        "properties": {
+          "index": {
+            "type": "integer",
+            "description": "Zero-based index of the batch currently executing."
+          },
+          "of": {
+            "type": "integer",
+            "description": "Total number of batches in the current phase."
+          },
+          "level": {
+            "type": "integer",
+            "description": "Dependency level (matches `dependencyLevel` from the topological sort)."
+          }
+        },
+        "required": [
+          "index",
+          "of",
+          "level"
+        ]
+      },
+      "SyncJob": {
+        "type": "object",
+        "description": "Sync job header as surfaced by `getSyncJob` and the create response. The\ncanonical persistence shape is described in `docs/sync/INTERFACES.md`.\n",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/SyncJobStatus"
+          },
+          "direction": {
+            "$ref": "#/components/schemas/SyncDirection"
+          },
+          "source_org_id": {
+            "type": "string"
+          },
+          "target_org_id": {
+            "type": "string"
+          },
+          "dry_run": {
+            "type": "boolean"
+          },
+          "counts": {
+            "$ref": "#/components/schemas/SyncJobCounts"
+          },
+          "current_phase": {
+            "$ref": "#/components/schemas/SyncPhase"
+          },
+          "current_batch": {
+            "$ref": "#/components/schemas/SyncJobBatch"
+          },
+          "started_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "finished_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "events": {
+            "type": "array",
+            "description": "Most recent events (capped server-side, typically last 10).",
+            "items": {
+              "$ref": "#/components/schemas/SyncJobEvent"
+            }
+          },
+          "errors_sample": {
+            "type": "array",
+            "description": "Up to 20 sample error messages from failed resources.",
+            "maxItems": 20,
+            "items": {
+              "type": "object",
+              "properties": {
+                "type": {
+                  "type": "string"
+                },
+                "source_id": {
+                  "type": "string"
+                },
+                "error": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "type",
+                "source_id",
+                "error"
+              ]
+            }
+          }
+        },
+        "required": [
+          "id",
+          "status",
+          "direction",
+          "source_org_id",
+          "target_org_id",
+          "dry_run",
+          "counts",
+          "started_at"
+        ]
+      },
+      "SyncJobListResponse": {
+        "type": "object",
+        "description": "Cursor-paginated list of sync jobs.",
+        "properties": {
+          "next_cursor": {
+            "type": "string"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SyncJob"
+            }
+          }
+        },
+        "required": [
+          "results"
+        ]
+      },
+      "SyncJobResource": {
+        "type": "object",
+        "description": "Per-resource row backed by `SyncResourcesTable`. See\n`docs/sync/INTERFACES.md` for the DDB shape.\n",
+        "properties": {
+          "type": {
+            "type": "string"
+          },
+          "source_id": {
+            "type": "string"
+          },
+          "target_id": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string",
+            "description": "Human-readable resource title captured from the source payload\nduring Phase 0. Lets clients identify rows without resolving\nraw UUIDs. Absent on rows written before this field existed.\n"
+          },
+          "status": {
+            "$ref": "#/components/schemas/SyncJobResourceStatus"
+          },
+          "phase": {
+            "$ref": "#/components/schemas/SyncPhase"
+          },
+          "attempt": {
+            "type": "integer"
+          },
+          "error": {
+            "type": "string"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "type",
+          "source_id",
+          "status",
+          "phase",
+          "attempt",
+          "updated_at"
+        ]
+      },
+      "SyncJobResourceListResponse": {
+        "type": "object",
+        "description": "Cursor-paginated list of sync job resources.",
+        "properties": {
+          "next_cursor": {
+            "type": "string"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SyncJobResource"
+            }
+          }
+        },
+        "required": [
+          "results"
+        ]
+      },
+      "DeleteJobStatus": {
+        "type": "string",
+        "description": "Lifecycle status of a bulk-delete job.",
+        "enum": [
+          "pending",
+          "in_progress",
+          "succeeded",
+          "partial",
+          "failed",
+          "cancelled"
+        ]
+      },
+      "DeleteJobResourceStatus": {
+        "type": "string",
+        "description": "Per-resource delete status. `skipped` is used for protected resources\nthat are intentionally not deleted (e.g. built-in schemas).\n",
+        "enum": [
+          "pending",
+          "in_progress",
+          "deleted",
+          "skipped",
+          "failed"
+        ]
+      },
+      "DeleteJobCounts": {
+        "type": "object",
+        "description": "Aggregate counters by resource delete status.",
+        "properties": {
+          "total": {
+            "type": "integer"
+          },
+          "pending": {
+            "type": "integer"
+          },
+          "in_progress": {
+            "type": "integer"
+          },
+          "deleted": {
+            "type": "integer"
+          },
+          "skipped": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "total",
+          "pending",
+          "in_progress",
+          "deleted",
+          "skipped",
+          "failed"
+        ]
+      },
+      "DeleteJobRequest": {
+        "type": "object",
+        "description": "Request body for `createDeleteJob`.",
+        "required": [
+          "resources"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Optional human-friendly job name shown in the history list."
+          },
+          "resources": {
+            "type": "array",
+            "description": "The resources to delete, by type + id.",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": [
+                "type",
+                "id"
+              ],
+              "properties": {
+                "type": {
+                  "type": "string",
+                  "description": "Resource type identifier"
+                },
+                "id": {
+                  "type": "string",
+                  "description": "Resource ID"
+                },
+                "title": {
+                  "type": "string",
+                  "description": "Optional human-readable title captured for the failures view."
+                }
+              }
+            }
+          }
+        }
+      },
+      "DeleteJob": {
+        "type": "object",
+        "description": "Bulk-delete job header surfaced by `createDeleteJob`/`getDeleteJob`.",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/DeleteJobStatus"
+          },
+          "org_id": {
+            "type": "string"
+          },
+          "counts": {
+            "$ref": "#/components/schemas/DeleteJobCounts"
+          },
+          "started_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "finished_at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "rebuild_triggered": {
+            "type": "boolean",
+            "description": "True once the worker has kicked the index rebuild on completion."
+          }
+        },
+        "required": [
+          "id",
+          "status",
+          "org_id",
+          "counts",
+          "started_at"
+        ]
+      },
+      "DeleteJobListResponse": {
+        "type": "object",
+        "description": "Cursor-paginated list of delete jobs.",
+        "properties": {
+          "next_cursor": {
+            "type": "string"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DeleteJob"
+            }
+          }
+        },
+        "required": [
+          "results"
+        ]
+      },
+      "DeleteJobResource": {
+        "type": "object",
+        "description": "Per-resource row for a delete job.",
+        "properties": {
+          "type": {
+            "type": "string"
+          },
+          "id": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          },
+          "status": {
+            "$ref": "#/components/schemas/DeleteJobResourceStatus"
+          },
+          "attempt": {
+            "type": "integer"
+          },
+          "error": {
+            "type": "string"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": [
+          "type",
+          "id",
+          "status",
+          "attempt",
+          "updated_at"
+        ]
+      },
+      "DeleteJobResourceListResponse": {
+        "type": "object",
+        "description": "Cursor-paginated list of delete job resources.",
+        "properties": {
+          "next_cursor": {
+            "type": "string"
+          },
+          "results": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DeleteJobResource"
+            }
+          }
+        },
+        "required": [
+          "results"
+        ]
+      },
+      "SnapshotInventoryItem": {
+        "type": "object",
+        "description": "Minimal identity of a single configuration resource.",
+        "properties": {
+          "type": {
+            "$ref": "#/components/schemas/ResourceType"
+          },
+          "id": {
+            "type": "string",
+            "description": "Unique identifier of the resource"
+          }
+        },
+        "required": [
+          "type",
+          "id"
+        ]
+      },
+      "SnapshotInventorySkippedType": {
+        "type": "object",
+        "description": "A type that could not be listed during inventory collection.",
+        "properties": {
+          "type": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "reason"
+        ]
+      },
+      "ConfigInventoryResponse": {
+        "type": "object",
+        "description": "Fresh inventory of all configuration resources for an org.",
+        "properties": {
+          "inventory_id": {
+            "type": "string",
+            "description": "Unique identifier for this inventory run (UUID)."
+          },
+          "org_id": {
+            "type": "string",
+            "description": "Organization ID the inventory was collected for."
+          },
+          "indexed_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "ISO timestamp of when the inventory was collected."
+          },
+          "resources_count": {
+            "type": "integer",
+            "description": "Total number of resources found across all types."
+          },
+          "resources": {
+            "type": "array",
+            "description": "List of all found resources as `{ type, id }` pairs.",
+            "items": {
+              "$ref": "#/components/schemas/SnapshotInventoryItem"
+            }
+          },
+          "skipped_types": {
+            "type": "array",
+            "description": "Types that failed to list or had no adapter; never fail the whole inventory.",
+            "items": {
+              "$ref": "#/components/schemas/SnapshotInventorySkippedType"
+            }
+          }
+        },
+        "required": [
+          "inventory_id",
+          "org_id",
+          "indexed_at",
+          "resources_count",
+          "resources",
+          "skipped_types"
+        ]
+      }
+    }
+  }
+}