{
"type": "about:blank",
"href": "https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types",
"title": "Bad Request",
"status": 400,
"detail": "The input message is incorrect",
"instance": "123456-1234-1235-4567489798",
"issues": [
{
"type": "about:blank",
"detail": "exampleNumericProperty should be numeric",
"in": "path",
"name": "exampleNumericProperty",
"value": "abc"
},
{
"type": "about:blank",
"title": "Input isn't valid with respect to schema",
"detail": "examplePropertyWithPattern a2345678901 doesn't match pattern '^\\d{11}$'",
"in": "body",
"name": "items[0].examplePropertyWithPattern",
"value": "a2345678901"
}
]
}
{
"type": "urn:problem-type:exampleOrganization:exampleProblem",
"href": "https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types",
"title": "Description of the type of problem that occurred",
"status": 400,
"detail": "Description of specific occurrence of the problem",
"instance": "urn:uuid:123e4567-e89b-12d3-a456-426614174000"
}
Integration
Batch upsert a group of integrations
This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the CLI’s deploy command rather than this API endpoint directly.
{
"type": "about:blank",
"href": "https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types",
"title": "Bad Request",
"status": 400,
"detail": "The input message is incorrect",
"instance": "123456-1234-1235-4567489798",
"issues": [
{
"type": "about:blank",
"detail": "exampleNumericProperty should be numeric",
"in": "path",
"name": "exampleNumericProperty",
"value": "abc"
},
{
"type": "about:blank",
"title": "Input isn't valid with respect to schema",
"detail": "examplePropertyWithPattern a2345678901 doesn't match pattern '^\\d{11}$'",
"in": "body",
"name": "items[0].examplePropertyWithPattern",
"value": "a2345678901"
}
]
}
{
"type": "urn:problem-type:exampleOrganization:exampleProblem",
"href": "https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types",
"title": "Description of the type of problem that occurred",
"status": 400,
"detail": "Description of specific occurrence of the problem",
"instance": "urn:uuid:123e4567-e89b-12d3-a456-426614174000"
}
Defaults to false. This flag controls whether to perform destructive actions when deploying integrations, like pausing all read actions for an object that was removed in the latest revision.
Body
application/json
The source of the integrations to upsert. One of sourceZipUrl or sourceYaml is required.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ampersand","colors":{"primary":"#1F71D6","light":"#F3F89B","dark":"#2B2B2B"},"logo":{"light":"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/light.png?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=7799b7c055eff93e5275bfee4335494b","dark":"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/dark.png?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=e83684af7f0f30de3c40d300c6e38ecf","href":"https://www.ampersand.ai"},"favicon":"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/favicon.svg?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=a58cf520454ff09433cb78f5ce10b2f2","api":{"openapi":["platform.json","read.json","write.json","search.json"]},"background":{"color":{"light":"#FDFBF9","dark":"#121212"}},"navbar":{"links":[{"href":"https://dashboard.withampersand.com/sign-in?trk=docs","label":"Sign in"}],"primary":{"type":"button","label":"Start building now","href":"https://dashboard.withampersand.com/sign-up?trk=docs"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/withampersand","twitter":"https://twitter.com/withampersand"}},"seo":{"indexing":"all"},"fonts":{"heading":{"family":"Helvetica Neue","weight":600,"source":"fonts/HelveticaNeue/HelveticaNeueMedium.woff2","format":"woff2"},"body":{"family":"Helvetica Neue","weight":500,"source":"fonts/HelveticaNeue/HelveticaNeueRoman.woff2","format":"woff2"}},"styling":{"codeblocks":"dark","latex":false},"integrations":{"gtm":{"tagId":"GTM-KKG4NLZD"}},"contextual":{"options":["copy","view"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ampersand-24eb5c1a","hasAudioNarration":false,"actualSubdomain":"ampersand-24eb5c1a","customDomains":["docs.ampersand.ai"],"gitSource":{"type":"github","owner":"amp-labs","repo":"docs","deployBranch":"main","contentDirectory":"src","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af51c43790b7393a89c4995","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Integrations","count":434},{"language":"default","tag":"All providers","count":203},{"language":"default","tag":"API Reference","count":91},{"language":"default","tag":"PLATFORM API","count":82},{"language":"default","tag":"Guides","count":36},{"language":"default","tag":"Customer guides","count":13},{"language":"default","tag":"Destinations","count":13},{"language":"default","tag":"Destination","count":12},{"language":"default","tag":"Org","count":12},{"language":"default","tag":"Installation","count":7}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"troubleshooting.css","content":".amp-ts{margin-top:1.5rem;letter-spacing:-0.0125rem}.amp-ts [hidden]{display:none!important}.amp-ts-controls{display:flex;flex-wrap:wrap;gap:10px;align-items:center}.amp-ts input.amp-ts-search{flex:1;min-width:240px;height:38px;padding:0 12px;border-radius:12px;border:1px solid var(--amp-border);background:var(--amp-surface-2);color:var(--amp-fg);font-size:15px;outline:none;transition:border-color 120ms ease}.amp-ts input.amp-ts-search:focus{border-color:var(--amp-accent)}.amp-ts input.amp-ts-search::placeholder{color:var(--amp-faint)}.amp-ts-chips{display:flex;flex-wrap:wrap;gap:8px}.amp-ts button.amp-ts-chip{height:32px;padding:0 12px;border:1px solid var(--amp-border);border-radius:12px;background:var(--amp-surface);color:var(--amp-muted);font-size:14px;font-family:inherit;cursor:pointer;transition:border-color 120ms ease, color 120ms ease}.amp-ts button.amp-ts-chip:hover{border-color:var(--amp-border-hover);color:var(--amp-fg)}.amp-ts button.amp-ts-chip.is-active{border-color:var(--amp-accent);color:var(--amp-accent)}.amp-ts-list{margin-top:6px}.amp-ts a.amp-ts-row{display:grid;grid-template-columns:minmax(0, 1fr) auto;align-items:center;gap:16px;padding:14px 4px;border-bottom:1px solid var(--amp-border-2);color:inherit;text-decoration:none;border-radius:0}.amp-ts a.amp-ts-row:hover .amp-ts-title{color:var(--amp-accent)}.amp-ts-title{font-size:16px;font-weight:500;color:var(--amp-fg);transition:color 120ms ease}.amp-ts-title code{font-size:13px}.amp-ts-desc{margin-top:4px;font-size:15px;line-height:1.6;color:var(--amp-muted)}.amp-ts-tag{font-family:var(--amp-mono);font-size:12px;color:var(--amp-muted-2);white-space:nowrap}.amp-ts-count{margin-top:12px;font-family:var(--amp-mono);font-size:12px;color:var(--amp-muted-2)}"},{"filePath":"fonts.css","content":"@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueThin.woff2\") format(\"woff2\");font-weight:100;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueLight.woff2\") format(\"woff2\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueRoman.woff2\") format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueMedium.woff2\") format(\"woff2\");font-weight:500 600;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueBold.woff2\") format(\"woff2\");font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:\"Helvetica Neue\";src:url(\"/fonts/HelveticaNeue/HelveticaNeueBlack.woff2\") format(\"woff2\");font-weight:900;font-style:normal;font-display:swap}"},{"filePath":"provider-grid.css","content":"html[data-current-path=\"/provider-guides/overview\"] #header{display:none}html[data-current-path=\"/provider-guides/overview\"] .mdx-content{max-width:none;margin-top:0}.amp-intg{max-width:1180px;margin:0 auto;color:var(--amp-fg);line-height:1.5}.amp-intg *{box-sizing:border-box}.amp-intg a{color:inherit;text-decoration:none}.amp-find-status,.amp-orbit-core i,.amp-node-label,.amp-intg-card-code,.amp-intg-card-cta{font-family:var(--amp-mono)}.amp-find-status,.amp-intg-head-sub{color:var(--amp-muted-2)}.amp-intg-eyebrow,.amp-intg-title-accent,.amp-intg-card-code,.amp-intg-card-cta{color:var(--amp-accent)}.amp-find-input,.amp-node a,.amp-node-label,.amp-cat-chips a,.amp-intg-card{border:1px solid var(--amp-border);background:var(--amp-surface)}.amp-cat-chips a:hover,.amp-cat-chips a:focus-visible,.amp-intg-card:hover{border-color:var(--amp-border-hover)}.amp-node a:focus-visible,.amp-cat-head:focus-visible{outline:2px solid var(--amp-accent)}.amp-intg-hero{display:grid;grid-template-columns:minmax(0, 1fr) minmax(0, 1.05fr);gap:56px;align-items:center;padding:40px 0 8px}.amp-intg-eyebrow{font-size:14px;font-weight:500;margin-bottom:12px}.amp-intg h1.amp-intg-title{margin:0;font-size:36px;line-height:44px;letter-spacing:-0.025em;font-weight:600;text-wrap:pretty}.amp-intg p.amp-intg-lede{margin:20px 0 0;font-size:16px;line-height:1.6;color:var(--amp-muted);max-width:46ch;text-wrap:pretty}.amp-find{margin-top:28px;max-width:360px}.amp-find-input{width:100%;height:40px;padding:0 12px;border-radius:8px;color:inherit;font:inherit;font-size:14px;outline:none;transition:border-color 120ms ease}.amp-find-input:focus{border-color:var(--amp-accent)}.amp-find-input::placeholder{color:var(--amp-faint)}.amp-find-status{margin-top:10px;font-size:11.5px;min-height:16px}.amp-orbit{position:relative;width:min(100%, 540px);aspect-ratio:1;margin:0 auto;container-type:inline-size}.amp-orbit::before,.amp-orbit::after{content:\"\";position:absolute;left:50%;top:50%;border-radius:50%;border:1px solid var(--amp-border-2);transform:translate(-50%, -50%);pointer-events:none}.amp-orbit::before{width:52cqw;height:52cqw}.amp-orbit::after{width:86cqw;height:86cqw;border-style:dashed}.amp-orbit-core{position:absolute;left:50%;top:50%;width:15cqw;height:15cqw;transform:translate(-50%, -50%);display:flex;flex-direction:column;align-items:center;justify-content:center;border-radius:50%;background:var(--amp-accent);box-shadow:0 10px 30px var(--amp-accent-soft);transition:transform 200ms ease, box-shadow 200ms ease}.amp-intg a.amp-orbit-core{color:#fff}html.dark .amp-intg a.amp-orbit-core{color:var(--amp-surface)}.amp-orbit-core:hover,.amp-orbit-core:focus-visible{transform:translate(-50%, -50%) scale(1.06);box-shadow:0 14px 36px var(--amp-accent-soft)}.amp-orbit-core b{font-size:4.2cqw;font-weight:600;line-height:1}.amp-orbit-core i{font-size:2.1cqw;font-style:normal;opacity:0.88;line-height:1.5}.amp-node{position:absolute;left:50%;top:50%;transform:translate(-50%, -50%)\n rotate(var(--a))\n translate(var(--r))\n rotate(calc(-1 * var(--a)))}.amp-node a{position:relative;display:grid;place-items:center;width:var(--sz);height:var(--sz);border-radius:50%;transition:transform 200ms cubic-bezier(0.34, 1.4, 0.64, 1), border-color 200ms ease}.amp-node--lg{--sz: 15cqw}.amp-node--sm{--sz: 9.5cqw}.amp-node img{width:62%;height:62%;object-fit:contain;border-radius:6px;background:#ffffff;padding:3%;pointer-events:none}.amp-node a:hover,.amp-node a:focus-visible{border-color:var(--amp-accent)}.amp-node--sm a:hover{transform:scale(1.12)}.amp-node a:focus-visible{outline-offset:3px}.amp-node:has(a:hover),.amp-node:has(a:focus-visible){z-index:3}.amp-node-label{position:absolute;top:calc(100% + 7px);left:50%;transform:translateX(-50%) translateY(3px);padding:3px 9px;border-radius:6px;font-size:11.5px;white-space:nowrap;opacity:0;pointer-events:none;transition:opacity 160ms ease, transform 160ms ease}.amp-node a:hover .amp-node-label,.amp-node a:focus-visible .amp-node-label{opacity:1;transform:translateX(-50%) translateY(0)}.amp-intg-section{padding-top:56px}.amp-intg-section--last{padding-bottom:72px}.amp-intg-head{display:flex;align-items:baseline;gap:14px;padding-bottom:18px;border-bottom:1px solid var(--amp-border-2)}.amp-intg h2.amp-intg-head-title{margin:0;font-size:15px;font-weight:600}.amp-intg-head-sub{font-size:13.5px}.amp-cats{margin-top:8px}.amp-cat{border-bottom:1px solid var(--amp-border-3)}.amp-cat-head{display:grid;grid-template-columns:10px minmax(0, 1fr);align-items:center;gap:14px;padding:17px 4px;cursor:pointer;user-select:none}.amp-cat-head:hover .amp-cat-name,.amp-cat-head:hover .amp-intg-head-title{color:var(--amp-accent)}.amp-cat-head:focus-visible{outline-offset:2px;border-radius:4px}.amp-cat-caret{width:0;height:0;border-left:5px solid var(--amp-faint);border-top:4px solid transparent;border-bottom:4px solid transparent;transition:transform 160ms ease}.amp-cat[data-open=\"true\"] .amp-cat-caret{transform:rotate(90deg);border-left-color:var(--amp-accent)}.amp-cat-name{font-size:14.5px;font-weight:500;letter-spacing:-0.005em;transition:color 120ms ease}.amp-cat:not([data-open=\"true\"]) .amp-cat-chips{display:none}.amp-cat-chips{display:flex;flex-wrap:wrap;gap:8px;padding:2px 4px 22px 24px}.amp-cat--section{border-bottom:0}.amp-intg-head.amp-cat-head{display:flex;align-items:baseline;padding:0 0 18px}.amp-cat--section .amp-cat-caret{align-self:center}.amp-cat--section .amp-cat-chips{padding-top:20px}.amp-cat-chips a{display:inline-flex;align-items:center;height:32px;padding:0 12px;border-radius:7px;font-size:13px;color:var(--amp-fg-2);white-space:nowrap;transition:border-color 120ms ease, color 120ms ease}.amp-cat-chips a:hover,.amp-cat-chips a:focus-visible{color:var(--amp-fg)}.amp-intg-cards{display:grid;grid-template-columns:repeat(auto-fit, minmax(260px, 1fr));gap:16px;margin-top:20px}.amp-intg-card{display:block;padding:20px;border-radius:10px;transition:border-color 120ms ease}.amp-intg-card-code{font-size:13.5px}.amp-intg-card-title{margin-top:10px;font-size:15px;font-weight:600;letter-spacing:-0.01em}.amp-intg-card-desc{margin-top:7px;font-size:14px;line-height:1.55;color:var(--amp-muted)}.amp-intg-card-cta{margin-top:14px;font-size:11.5px}@media (max-width: 960px){.amp-intg-hero{grid-template-columns:minmax(0, 1fr);gap:36px}.amp-intg h1.amp-intg-title{font-size:30px;line-height:38px}}@media (max-width: 640px){.amp-intg h1.amp-intg-title{font-size:27px;line-height:34px}.amp-intg-head{flex-direction:column;align-items:flex-start;gap:6px}.amp-cat-chips{padding-left:4px}}@media (prefers-reduced-motion: no-preference){.amp-node a{animation:amp-bob 6s ease-in-out infinite;animation-delay:var(--d, 0s)}.amp-node a:hover,.amp-node a:focus-visible{animation-play-state:paused}.amp-orbit::after{animation:amp-spin 90s linear infinite}}@keyframes amp-bob{0%,100%{translate:0 0}50%{translate:0 -5px}}@keyframes amp-spin{from{transform:translate(-50%, -50%) rotate(0deg)}to{transform:translate(-50%, -50%) rotate(360deg)}}@media (prefers-reduced-motion: reduce){.amp-node a{animation:none;transition:border-color 160ms ease}.amp-node--sm a:hover{transform:none}.amp-orbit::after{animation:none}.amp-cat-caret{transition:none}.amp-orbit-core:hover,.amp-orbit-core:focus-visible{transform:translate(-50%, -50%)}}.amp-cat[hidden],.amp-cat-chips a[hidden]{display:none!important}"},{"filePath":"shared-variables.css","content":":root{--amp-fg: rgb(var(--gray-900));--amp-fg-2: rgb(var(--gray-700));--amp-muted: rgb(var(--gray-600));--amp-muted-2: rgb(var(--gray-500));--amp-faint: rgb(var(--gray-400));--amp-accent: rgb(var(--primary));--amp-accent-hover: rgb(var(--primary-dark));--amp-accent-soft: rgb(var(--primary) / 0.16);--amp-surface: rgb(var(--background-light));--amp-surface-2: rgb(var(--gray-950) / 0.04);--amp-border: rgb(var(--gray-950) / 0.1);--amp-border-2: rgb(var(--gray-950) / 0.07);--amp-border-3: rgb(var(--gray-950) / 0.05);--amp-border-hover: rgb(var(--gray-950) / 0.22);--amp-mono: var(--font-family-mono-custom, var(--font-jetbrains-mono, ui-monospace)),\n \"SF Mono\", SFMono-Regular, Menlo, monospace}html.dark{--amp-fg: rgb(var(--gray-100));--amp-fg-2: rgb(var(--gray-300));--amp-muted: rgb(var(--gray-400));--amp-muted-2: rgb(var(--gray-400));--amp-faint: rgb(var(--gray-500));--amp-accent: rgb(var(--primary-light));--amp-accent-hover: rgb(var(--primary-light));--amp-accent-soft: rgb(var(--primary-light) / 0.22);--amp-surface: rgb(var(--background-dark));--amp-surface-2: rgb(255 255 255 / 0.05);--amp-border: rgb(255 255 255 / 0.13);--amp-border-2: rgb(255 255 255 / 0.09);--amp-border-3: rgb(255 255 255 / 0.07);--amp-border-hover: rgb(255 255 255 / 0.3)}"}],"page":{"pagePath":"reference/integration/batch-upsert-a-group-of-integrations","slug":"/reference/integration/batch-upsert-a-group-of-integrations","pageMetadata":{"openapi":"platform put /projects/{projectIdOrName}/integrations:batch","title":"Batch upsert a group of integrations","description":"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the [CLI's deploy command](https://docs.ampersand.ai/cli/overview#deploy-integrations) rather than this API endpoint directly.","href":"/reference/integration/batch-upsert-a-group-of-integrations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the \", _jsx(_components.a, {\n href: \"https://docs.ampersand.ai/cli/overview#deploy-integrations\",\n children: \"CLI’s deploy command\"\n }), \" rather than this API endpoint directly.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"openapi":"platform put /projects/{projectIdOrName}/integrations:batch","title":"Batch upsert a group of integrations","description":"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the [CLI's deploy command](https://docs.ampersand.ai/cli/overview#deploy-integrations) rather than this API endpoint directly.","href":"/reference/integration/batch-upsert-a-group-of-integrations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ampersand-24eb5c1a/918af64092960fd7/troubleshooting.js","/_mintlify/custom/ampersand-24eb5c1a/0bf41ceae2eadd8d/provider-grid.js","/_mintlify/custom/ampersand-24eb5c1a/8d356ec11ed170d1/analytics.js"],"openApiReferenceData":{"operation":{"summary":"Batch upsert a group of integrations","operationId":"batchUpsertIntegrations","description":"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the [CLI's deploy command](https://docs.ampersand.ai/cli/overview#deploy-integrations) rather than this API endpoint directly.","tags":["Integration"],"parameters":["edec6dec-0b68-42d1-8f48-5ef2d0d67418","80cd14b2-dd48-4755-9299-cb75711a1535"],"requestBody":"dc96dc06-e6f8-4d13-a302-b1c8f3e7d3e5","responses":{"200":"496e73aa-d049-4453-a7da-114bf6ba6f2e","422":"ad12b4a3-7784-41f4-a36d-065d61ad9195","default":"d140d354-c234-4222-b34c-af9a1636d0a0"},"method":"put","type":"path","servers":["206ff708-4056-46c3-9d88-57beb150dc00"],"security":["17336596-ef60-41a5-9799-1b9c5a164c47","c8875d4b-1bf3-448c-8f78-777a84b34792"],"path":"/projects/{projectIdOrName}/integrations:batch","baseUrlOptions":["https://api.ampersand.ai/v1"],"title":"Batch upsert a group of integrations","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"edec6dec-0b68-42d1-8f48-5ef2d0d67418":{"name":"projectIdOrName","in":"path","required":true,"description":"The Ampersand project ID or project name.","schema":{"type":"string","isRequired":true,"description":"The Ampersand project ID or project name.","uniqueKey":"","typeLabel":"string"},"example":"my-project"},"80cd14b2-dd48-4755-9299-cb75711a1535":{"name":"destructive","in":"query","required":false,"description":"Defaults to false. This flag controls whether to perform destructive actions when deploying integrations, like pausing all read actions for an object that was removed in the latest revision.","schema":{"type":"boolean","isRequired":false,"description":"Defaults to false. This flag controls whether to perform destructive actions when deploying integrations, like pausing all read actions for an object that was removed in the latest revision.","uniqueKey":"","typeLabel":"boolean"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sourceZipUrl":{"type":"string","description":"URL of where a zip of the source files can be downloaded (e.g. Google Cloud Storage URL).","example":"https://storage.googleapis.com/my-bucket/source-files/integration-v1.2.3.zip","uniqueKey":"sourceZipUrl","typeLabel":"string"},"sourceYaml":{"type":"string","description":"A YAML string that defines the integrations.","uniqueKey":"sourceYaml","typeLabel":"string"}},"description":"The source of the integrations to upsert. One of sourceZipUrl or sourceYaml is required.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"sourceZipUrl":"https://storage.googleapis.com/my-bucket/source-files/integration-v1.2.3.zip","sourceYaml":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"496e73aa-d049-4453-a7da-114bf6ba6f2e":{"description":"Upserted integrations.","content":{"application/json":{"schema":{"type":"array","items":{"title":"Integration","required":["createTime","id","latestRevision","name","projectId","provider"],"type":"object","properties":{"id":{"type":"string","description":"The integration ID.","isRequired":true,"uniqueKey":"items.[INDEX].id","typeLabel":"string"},"projectId":{"type":"string","description":"The Ampersand project ID.","example":"project-456","isRequired":true,"uniqueKey":"items.[INDEX].projectId","typeLabel":"string"},"name":{"type":"string","description":"The integration name.","example":"read-accounts","isRequired":true,"uniqueKey":"items.[INDEX].name","typeLabel":"string"},"provider":{"type":"string","description":"The SaaS provider that this integration connects to.","example":"salesforce","isRequired":true,"uniqueKey":"items.[INDEX].provider","typeLabel":"string"},"createTime":{"type":"string","description":"The time the integration was created.","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].createTime","typeLabel":"string\u003cdate-time>"},"latestRevision":{"title":"Revision","required":["content","createTime","id","specVersion"],"type":"object","properties":{"id":{"type":"string","description":"The revision ID.","example":"revision-id-1","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.id","typeLabel":"string"},"specVersion":{"type":"string","description":"The spec version string.","example":"1.0.0","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.specVersion","typeLabel":"string"},"createTime":{"type":"string","description":"The time the revision was created.","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.createTime","typeLabel":"string\u003cdate-time>"},"content":{"title":"Integration","type":"object","required":["name","provider"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.name","typeLabel":"string"},"provider":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.provider","typeLabel":"string"},"displayName":{"type":"string","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.displayName","typeLabel":"string"},"module":{"type":"string","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.module","typeLabel":"string"},"read":{"title":"Read Integration","type":"object","properties":{"objects":{"type":"array","items":{"title":"Integration Object","type":"object","required":["objectName","destination","schedule"],"properties":{"objectName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].objectName","typeLabel":"string"},"destination":{"type":"string","x-go-type-skip-optional-pointer":true,"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].destination","typeLabel":"string"},"schedule":{"type":"string","x-go-type-skip-optional-pointer":true,"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].schedule","typeLabel":"string"},"mapToName":{"type":"string","description":"An object name to map to.","example":"people","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].mapToName","typeLabel":"string"},"mapToDisplayName":{"type":"string","description":"A display name to map to.","example":"People","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].mapToDisplayName","typeLabel":"string"},"requiredFields":{"type":"array","items":{"oneOf":[{"type":"object","title":"Integration Field Existent","required":["fieldName"],"properties":{"fieldName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.0.fieldName","typeLabel":"string"},"mapToName":{"type":"string","description":"The field name to map to.","example":"account_id","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.0.mapToName","typeLabel":"string"},"mapToDisplayName":{"type":"string","description":"The display name to map to.","example":"Account ID","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.0.mapToDisplayName","typeLabel":"string"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.0","typeLabel":"Integration Field Existent · object"},{"type":"object","title":"Integration Field Mapping","required":["mapToName"],"properties":{"mapToName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.1.mapToName","typeLabel":"string"},"mapToDisplayName":{"type":"string","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.1.mapToDisplayName","typeLabel":"string"},"default":{"type":"string","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.1.default","typeLabel":"string"},"prompt":{"type":"string","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.1.prompt","typeLabel":"string"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX].oneOf.1","typeLabel":"Integration Field Mapping · object"}],"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields.items.[INDEX]","typeLabel":"Integration Field Existent · object | Integration Field Mapping · object"},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].requiredFields","typeLabel":"(Integration Field Existent · object | Integration Field Mapping · object)[]"},"optionalFields":{"type":"array","items":{"oneOf":[{"type":"object","title":"Integration Field Existent","required":["fieldName"],"properties":{"fieldName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.0.fieldName","typeLabel":"string"},"mapToName":{"type":"string","description":"The field name to map to.","example":"account_id","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.0.mapToName","typeLabel":"string"},"mapToDisplayName":{"type":"string","description":"The display name to map to.","example":"Account ID","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.0.mapToDisplayName","typeLabel":"string"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.0","typeLabel":"Integration Field Existent · object"},{"type":"object","title":"Integration Field Mapping","required":["mapToName"],"properties":{"mapToName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.1.mapToName","typeLabel":"string"},"mapToDisplayName":{"type":"string","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.1.mapToDisplayName","typeLabel":"string"},"default":{"type":"string","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.1.default","typeLabel":"string"},"prompt":{"type":"string","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.1.prompt","typeLabel":"string"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX].oneOf.1","typeLabel":"Integration Field Mapping · object"}],"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields.items.[INDEX]","typeLabel":"Integration Field Existent · object | Integration Field Mapping · object"},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFields","typeLabel":"(Integration Field Existent · object | Integration Field Mapping · object)[]"},"optionalFieldsAuto":{"title":"Optional Fields Auto Option","type":"string","enum":["all"],"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].optionalFieldsAuto","typeLabel":"enum\u003cstring>"},"backfill":{"title":"Backfill","type":"object","required":["defaultPeriod"],"properties":{"defaultPeriod":{"title":"Default Period","type":"object","properties":{"days":{"type":"integer","description":"Number of days in past to backfill from. 0 is no backfill. e.g) if 10, then backfill last 10 days of data. Required if fullHistory is not set.","minimum":0,"example":30,"x-oapi-codegen-extra-tags":{"validate":"required_without=FullHistory,omitempty,min=0"},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].backfill.defaultPeriod.days","typeLabel":"integer"},"fullHistory":{"type":"boolean","description":"If true, backfill all history. Required if days is not set.","example":false,"x-oapi-codegen-extra-tags":{"validate":"required_without=Days"},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].backfill.defaultPeriod.fullHistory","typeLabel":"boolean"}},"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].backfill.defaultPeriod","typeLabel":"Default Period · object"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].backfill","typeLabel":"Backfill · object"},"delivery":{"title":"Delivery","type":"object","properties":{"mode":{"type":"string","default":"auto","enum":["onRequest","auto"],"description":"The data delivery mode for this object. If not specified, defaults to automatic.","uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].delivery.mode","typeLabel":"enum\u003cstring>"},"pageSize":{"type":"integer","description":"The number of records to receive per data delivery.","minimum":50,"maximum":500,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].delivery.pageSize","typeLabel":"integer"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].delivery","typeLabel":"Delivery · object"},"enabled":{"type":"string","description":"If set to `always`, Ampersand reads this object for every installation even if the customer never selects it (or it isn't present) in the installation config.\n","enum":["always"],"x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX].enabled","typeLabel":"enum\u003cstring>"}},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects.items.[INDEX]","typeLabel":"Integration Object · object"},"uniqueKey":"items.[INDEX].latestRevision.content.read.objects","typeLabel":"Integration Object · object[]"}},"uniqueKey":"items.[INDEX].latestRevision.content.read","typeLabel":"Read Integration · object"},"write":{"title":"Write Integration","type":"object","properties":{"objects":{"type":"array","items":{"title":"Integration Write Object","type":"object","required":["objectName"],"properties":{"objectName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.write.objects.items.[INDEX].objectName","typeLabel":"string"},"inheritMapping":{"type":"boolean","description":"If true, the write object will inherit the mapping from the read object. If false, the write object will have no mapping.","example":true,"uniqueKey":"items.[INDEX].latestRevision.content.write.objects.items.[INDEX].inheritMapping","typeLabel":"boolean"},"valueDefaults":{"title":"Value Defaults","type":"object","description":"Configuration to set default write values for object fields.","properties":{"allowAnyFields":{"type":"boolean","description":"If true, users can set default values for any field.","example":true,"uniqueKey":"items.[INDEX].latestRevision.content.write.objects.items.[INDEX].valueDefaults.allowAnyFields","typeLabel":"boolean"}},"uniqueKey":"items.[INDEX].latestRevision.content.write.objects.items.[INDEX].valueDefaults","typeLabel":"Value Defaults · object"}},"uniqueKey":"items.[INDEX].latestRevision.content.write.objects.items.[INDEX]","typeLabel":"Integration Write Object · object"},"uniqueKey":"items.[INDEX].latestRevision.content.write.objects","typeLabel":"Integration Write Object · object[]"}},"uniqueKey":"items.[INDEX].latestRevision.content.write","typeLabel":"Write Integration · object"},"proxy":{"title":"Proxy Integration","type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"items.[INDEX].latestRevision.content.proxy.enabled","typeLabel":"boolean"},"useModule":{"type":"boolean","description":"Default is false. If this is set to true, the base URL for the proxy action will be the module's base URL. Otherwise, it is assumed that the base URL is the provider's root base URL.","uniqueKey":"items.[INDEX].latestRevision.content.proxy.useModule","typeLabel":"boolean"}},"uniqueKey":"items.[INDEX].latestRevision.content.proxy","typeLabel":"Proxy Integration · object"},"subscribe":{"title":"Subscribe Integration","type":"object","properties":{"objects":{"type":"array","items":{"title":"Integration Subscribe Object","type":"object","required":["objectName","destination"],"properties":{"objectName":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].objectName","typeLabel":"string"},"destination":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].destination","typeLabel":"string"},"inheritFieldsAndMapping":{"type":"boolean","x-go-type-skip-optional-pointer":true,"description":"If true, the integration will inherit the fields and mapping from the read object.","example":true,"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].inheritFieldsAndMapping","typeLabel":"boolean"},"createEvent":{"type":"object","properties":{"enabled":{"type":"string","description":"If always, the integration will subscribe to create events by default.","enum":["always"],"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].createEvent.enabled","typeLabel":"enum\u003cstring>"}},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].createEvent","typeLabel":"object"},"updateEvent":{"type":"object","properties":{"enabled":{"type":"string","description":"If always, the integration will subscribe to update events by default.","enum":["always"],"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].updateEvent.enabled","typeLabel":"enum\u003cstring>"},"watchFieldsAuto":{"type":"string","description":"If `all`, the integration will watch all fields for updates. If `selected`, the integration will watch only the fields that are selected by the user. If `inheritFieldsAndMapping` is true for Subscribe action, the integration will watch the selected fields from read action that are selected by the user.","enum":["all","selected"],"example":"all","uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].updateEvent.watchFieldsAuto","typeLabel":"enum\u003cstring>"},"requiredWatchFields":{"type":"array","items":{"type":"string","description":"The fields that are required to be watched for updates.","example":["name","domain"],"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].updateEvent.requiredWatchFields.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].updateEvent.requiredWatchFields","typeLabel":"string[]"}},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].updateEvent","typeLabel":"object"},"deleteEvent":{"type":"object","properties":{"enabled":{"type":"string","description":"If always, the integration will subscribe to delete events by default.","enum":["always"],"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].deleteEvent.enabled","typeLabel":"enum\u003cstring>"}},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].deleteEvent","typeLabel":"object"},"associationChangeEvent":{"type":"object","properties":{"enabled":{"type":"string","description":"If always, the integration will subscribe to association change events.","enum":["always"],"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].associationChangeEvent.enabled","typeLabel":"enum\u003cstring>"},"includeFullRecords":{"type":"boolean","description":"If true, the integration will include full records in the event payload.","uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].associationChangeEvent.includeFullRecords","typeLabel":"boolean"}},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].associationChangeEvent","typeLabel":"object"},"otherEvents":{"type":"array","items":{"type":"string","description":"Non-standard events that the integration will subscribe to.","example":["object.merged","object.restored"],"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].otherEvents.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX].otherEvents","typeLabel":"string[]"}},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects.items.[INDEX]","typeLabel":"Integration Subscribe Object · object"},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe.objects","typeLabel":"Integration Subscribe Object · object[]"}},"uniqueKey":"items.[INDEX].latestRevision.content.subscribe","typeLabel":"Subscribe Integration · object"},"watchSchema":{"title":"Provider schema watch","type":"object","description":"Configuration for monitoring provider schema changes.","required":["destination","allObjects"],"properties":{"destination":{"type":"string","description":"The destination to send schema change notifications to.","example":"fieldWatchStream","x-go-type-skip-optional-pointer":true,"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.destination","typeLabel":"string"},"allObjects":{"title":"Watch Schema All Objects","type":"object","description":"Schema change event configuration for all objects in the integration.","properties":{"fieldCreated":{"title":"Field Created Event","type":"object","description":"Configuration for detecting when new fields are created.","required":["enabled"],"properties":{"enabled":{"type":"string","description":"If always, the integration will monitor for new fields by default.","enum":["always"],"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects.fieldCreated.enabled","typeLabel":"enum\u003cstring>"}},"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects.fieldCreated","typeLabel":"Field Created Event · object"},"fieldDeleted":{"title":"Field Deleted Event","type":"object","description":"Configuration for detecting when fields are deleted.","required":["enabled"],"properties":{"enabled":{"type":"string","description":"If always, the integration will monitor for deleted fields by default.","enum":["always"],"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects.fieldDeleted.enabled","typeLabel":"enum\u003cstring>"}},"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects.fieldDeleted","typeLabel":"Field Deleted Event · object"},"fieldChanged":{"title":"Field Changed Event","type":"object","description":"Configuration for detecting when fields are changed.","required":["enabled"],"properties":{"enabled":{"type":"string","description":"If always, the integration will monitor for field changes by default.","enum":["always"],"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects.fieldChanged.enabled","typeLabel":"enum\u003cstring>"}},"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects.fieldChanged","typeLabel":"Field Changed Event · object"}},"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.allObjects","typeLabel":"Watch Schema All Objects · object"},"schedule":{"type":"string","description":"Cron schedule for checking schema changes. Minimum frequency is once per hour. Defaults to once a day.","default":"0 */24 * * *","example":"0 */6 * * *","x-go-type-skip-optional-pointer":true,"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema.schedule","typeLabel":"string"}},"uniqueKey":"items.[INDEX].latestRevision.content.watchSchema","typeLabel":"Provider schema watch · object"}},"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision.content","typeLabel":"Integration · object"}},"isRequired":true,"uniqueKey":"items.[INDEX].latestRevision","typeLabel":"Revision · object"},"updateTime":{"type":"string","description":"The time the integration was last updated.","format":"date-time","uniqueKey":"items.[INDEX].updateTime","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"items.[INDEX]","typeLabel":"Integration · object"},"uniqueKey":"","typeLabel":"Integration · object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"\u003cstring>","projectId":"project-456","name":"read-accounts","provider":"salesforce","createTime":"2023-11-07T05:31:56Z","latestRevision":{"id":"revision-id-1","specVersion":"1.0.0","createTime":"2023-11-07T05:31:56Z","content":{"name":"\u003cstring>","provider":"\u003cstring>","displayName":"\u003cstring>","module":"\u003cstring>","read":{"objects":[{"objectName":"\u003cstring>","destination":"\u003cstring>","schedule":"\u003cstring>","mapToName":"people","mapToDisplayName":"People","requiredFields":[{"fieldName":"\u003cstring>","mapToName":"account_id","mapToDisplayName":"Account ID"}],"optionalFields":[{"fieldName":"\u003cstring>","mapToName":"account_id","mapToDisplayName":"Account ID"}],"optionalFieldsAuto":"all","backfill":{"defaultPeriod":{"days":30,"fullHistory":false}},"delivery":{"mode":"auto","pageSize":275},"enabled":"always"}]},"write":{"objects":[{"objectName":"\u003cstring>","inheritMapping":true,"valueDefaults":{"allowAnyFields":true}}]},"proxy":{"enabled":true,"useModule":true},"subscribe":{"objects":[{"objectName":"\u003cstring>","destination":"\u003cstring>","inheritFieldsAndMapping":true,"createEvent":{"enabled":"always"},"updateEvent":{"enabled":"always","watchFieldsAuto":"all","requiredWatchFields":[["name","domain"]]},"deleteEvent":{"enabled":"always"},"associationChangeEvent":{"enabled":"always","includeFullRecords":true},"otherEvents":[["object.merged","object.restored"]]}]},"watchSchema":{"destination":"fieldWatchStream","allObjects":{"fieldCreated":{"enabled":"always"},"fieldDeleted":{"enabled":"always"},"fieldChanged":{"enabled":"always"}},"schedule":"0 */6 * * *"}}},"updateTime":"2023-11-07T05:31:56Z"}]}},"exampleType":"generated"}},"exampleType":"generated"},"ad12b4a3-7784-41f4-a36d-065d61ad9195":{"description":"Unprocessable Entity","content":{"application/problem+json":{"schema":{"type":"object","title":"Input Validation Problem","description":"A Problem Details object (RFC 9457).\n\nAdditional properties specific to the problem type may be present.\n","example":{"type":"about:blank","href":"https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types","title":"Bad Request","status":400,"detail":"The input message is incorrect","instance":"123456-1234-1235-4567489798","issues":[{"type":"about:blank","detail":"exampleNumericProperty should be numeric","in":"path","name":"exampleNumericProperty","value":"abc"},{"type":"about:blank","title":"Input isn't valid with respect to schema","detail":"examplePropertyWithPattern a2345678901 doesn't match pattern '^\\d{11}$'","in":"body","name":"items[0].examplePropertyWithPattern","value":"a2345678901"}]},"properties":{"type":{"type":"string","format":"uri","description":"An absolute URI that identifies the problem type","default":"about:blank","uniqueKey":"type","typeLabel":"string\u003curi>"},"href":{"type":"string","format":"uri","description":"An absolute URI that, when dereferenced, provides human-readable documentation for the problem type (e.g. using HTML).","uniqueKey":"href","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"A short summary of the problem type. Written in English and readable for engineers (usually not suited for non technical stakeholders and not localized).","example":"Service Unavailable","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","format":"int32","description":"The HTTP status code generated by the origin server for this occurrence of the problem.","minimum":400,"maximum":600,"exclusiveMaximum":true,"example":503,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","uniqueKey":"instance","typeLabel":"string\u003curi>"},"subsystem":{"type":"string","description":"The subsystem that generated the problem","example":"api","uniqueKey":"subsystem","typeLabel":"string"},"time":{"type":"string","format":"date-time","description":"The time the problem occurred, formatted as RFC-3339","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"time","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","description":"A unique identifier for the request, useful for debugging","example":"89eb1ffb-2a54-4105-aaae-7bf990f1aa69#87715","uniqueKey":"requestId","typeLabel":"string"},"causes":{"type":"array","items":{"type":"string","description":"A brief description of something which caused the problem","example":"database connection failed","uniqueKey":"causes.items.[INDEX]","typeLabel":"string"},"example":["database connection failed","database query failed","unable to fetch user"],"description":"A list of problems that caused this problem. This can be used to represent multiple\nroot causes. There is no guaranteed ordering of the causes.\n","uniqueKey":"causes","typeLabel":"string[]"},"remedy":{"type":"string","description":"A brief description of how to resolve the problem","example":"Shorten your input to be under 100 characters","uniqueKey":"remedy","typeLabel":"string"},"supportEmail":{"type":"string","format":"email","description":"An email address to contact for support","example":"support@withampersand.com","uniqueKey":"supportEmail","typeLabel":"string\u003cemail>"},"supportPhone":{"type":"string","description":"A phone number to contact for support","example":"+1-555-555-5555","uniqueKey":"supportPhone","typeLabel":"string"},"supportUrl":{"type":"string","format":"uri","description":"A URL to contact for support","example":"mailto:support@withampersand.com","uniqueKey":"supportUrl","typeLabel":"string\u003curi>"},"retryable":{"type":"boolean","description":"Whether the request can be retried","example":false,"uniqueKey":"retryable","typeLabel":"boolean"},"retryAfter":{"type":"string","format":"date-time","description":"A timestamp after which the request can be retried, formatted as RFC-3339","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"retryAfter","typeLabel":"string\u003cdate-time>"},"context":{"type":"object","description":"Additional context for the problem","additionalProperties":true,"example":{"name":"Rick Sanchez"},"uniqueKey":"context","typeLabel":"object"},"issues":{"type":"array","items":{"type":"object","title":"Input Validation Issue","description":"An issue detected during input validation.\n","example":{"type":"urn:problem-type:exampleOrganization:exampleProblem","href":"https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types","title":"Description of the type of problem that occurred","status":400,"detail":"Description of specific occurrence of the problem","instance":"urn:uuid:123e4567-e89b-12d3-a456-426614174000"},"properties":{"type":{"type":"string","format":"uri","description":"An absolute URI that identifies the problem type","default":"about:blank","uniqueKey":"issues.items.[INDEX].type","typeLabel":"string\u003curi>"},"href":{"type":"string","format":"uri","description":"An absolute URI that, when dereferenced, provides human-readable documentation for the problem type (e.g. using HTML).","uniqueKey":"issues.items.[INDEX].href","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"A short summary of the problem type. Written in English and readable for engineers (usually not suited for non technical stakeholders and not localized).","example":"Service Unavailable","uniqueKey":"issues.items.[INDEX].title","typeLabel":"string"},"status":{"type":"integer","format":"int32","description":"The HTTP status code generated by the origin server for this occurrence of the problem.","minimum":400,"maximum":600,"exclusiveMaximum":true,"example":503,"uniqueKey":"issues.items.[INDEX].status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"issues.items.[INDEX].detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","uniqueKey":"issues.items.[INDEX].instance","typeLabel":"string\u003curi>"},"subsystem":{"type":"string","description":"The subsystem that generated the problem","example":"api","uniqueKey":"issues.items.[INDEX].subsystem","typeLabel":"string"},"time":{"type":"string","format":"date-time","description":"The time the problem occurred, formatted as RFC-3339","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"issues.items.[INDEX].time","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","description":"A unique identifier for the request, useful for debugging","example":"89eb1ffb-2a54-4105-aaae-7bf990f1aa69#87715","uniqueKey":"issues.items.[INDEX].requestId","typeLabel":"string"},"causes":{"type":"array","items":{"type":"string","description":"A brief description of something which caused the problem","example":"database connection failed","uniqueKey":"issues.items.[INDEX].causes.items.[INDEX]","typeLabel":"string"},"example":["database connection failed","database query failed","unable to fetch user"],"description":"A list of problems that caused this problem. This can be used to represent multiple\nroot causes. There is no guaranteed ordering of the causes.\n","uniqueKey":"issues.items.[INDEX].causes","typeLabel":"string[]"},"remedy":{"type":"string","description":"A brief description of how to resolve the problem","example":"Shorten your input to be under 100 characters","uniqueKey":"issues.items.[INDEX].remedy","typeLabel":"string"},"supportEmail":{"type":"string","format":"email","description":"An email address to contact for support","example":"support@withampersand.com","uniqueKey":"issues.items.[INDEX].supportEmail","typeLabel":"string\u003cemail>"},"supportPhone":{"type":"string","description":"A phone number to contact for support","example":"+1-555-555-5555","uniqueKey":"issues.items.[INDEX].supportPhone","typeLabel":"string"},"supportUrl":{"type":"string","format":"uri","description":"A URL to contact for support","example":"mailto:support@withampersand.com","uniqueKey":"issues.items.[INDEX].supportUrl","typeLabel":"string\u003curi>"},"retryable":{"type":"boolean","description":"Whether the request can be retried","example":false,"uniqueKey":"issues.items.[INDEX].retryable","typeLabel":"boolean"},"retryAfter":{"type":"string","format":"date-time","description":"A timestamp after which the request can be retried, formatted as RFC-3339","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"issues.items.[INDEX].retryAfter","typeLabel":"string\u003cdate-time>"},"context":{"type":"object","description":"Additional context for the problem","additionalProperties":true,"example":{"name":"Rick Sanchez"},"uniqueKey":"issues.items.[INDEX].context","typeLabel":"object"},"in":{"type":"string","description":"The location of the invalid input","enum":["body","header","path","query"],"uniqueKey":"issues.items.[INDEX].in","typeLabel":"enum\u003cstring>"},"name":{"type":"string","description":"The name of the invalid input","uniqueKey":"issues.items.[INDEX].name","typeLabel":"string"},"value":{"description":"The value of the erroneous input","uniqueKey":"issues.items.[INDEX].value","typeLabel":"any"}},"uniqueKey":"issues.items.[INDEX]","typeLabel":"Input Validation Issue · object"},"uniqueKey":"issues","typeLabel":"Input Validation Issue · object[]"}},"uniqueKey":"","typeLabel":"Input Validation Problem · object"},"examples":{"Example":{"title":"Example","value":{"type":"about:blank","href":"https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types","title":"Bad Request","status":400,"detail":"The input message is incorrect","instance":"123456-1234-1235-4567489798","issues":[{"type":"about:blank","detail":"exampleNumericProperty should be numeric","in":"path","name":"exampleNumericProperty","value":"abc"},{"type":"about:blank","title":"Input isn't valid with respect to schema","detail":"examplePropertyWithPattern a2345678901 doesn't match pattern '^\\d{11}$'","in":"body","name":"items[0].examplePropertyWithPattern","value":"a2345678901"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d140d354-c234-4222-b34c-af9a1636d0a0":{"description":"Error","content":{"application/problem+json":{"schema":{"type":"object","title":"API Problem","description":"A Problem Details object (RFC 9457).\n\nAdditional properties specific to the problem type may be present.\n","example":{"type":"urn:problem-type:exampleOrganization:exampleProblem","href":"https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types","title":"Description of the type of problem that occurred","status":400,"detail":"Description of specific occurrence of the problem","instance":"urn:uuid:123e4567-e89b-12d3-a456-426614174000"},"properties":{"type":{"type":"string","format":"uri","description":"An absolute URI that identifies the problem type","default":"about:blank","uniqueKey":"type","typeLabel":"string\u003curi>"},"href":{"type":"string","format":"uri","description":"An absolute URI that, when dereferenced, provides human-readable documentation for the problem type (e.g. using HTML).","uniqueKey":"href","typeLabel":"string\u003curi>"},"title":{"type":"string","description":"A short summary of the problem type. Written in English and readable for engineers (usually not suited for non technical stakeholders and not localized).","example":"Service Unavailable","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","format":"int32","description":"The HTTP status code generated by the origin server for this occurrence of the problem.","minimum":400,"maximum":600,"exclusiveMaximum":true,"example":503,"uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","format":"uri","description":"An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.","uniqueKey":"instance","typeLabel":"string\u003curi>"},"subsystem":{"type":"string","description":"The subsystem that generated the problem","example":"api","uniqueKey":"subsystem","typeLabel":"string"},"time":{"type":"string","format":"date-time","description":"The time the problem occurred, formatted as RFC-3339","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"time","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","description":"A unique identifier for the request, useful for debugging","example":"89eb1ffb-2a54-4105-aaae-7bf990f1aa69#87715","uniqueKey":"requestId","typeLabel":"string"},"causes":{"type":"array","items":{"type":"string","description":"A brief description of something which caused the problem","example":"database connection failed","uniqueKey":"causes.items.[INDEX]","typeLabel":"string"},"example":["database connection failed","database query failed","unable to fetch user"],"description":"A list of problems that caused this problem. This can be used to represent multiple\nroot causes. There is no guaranteed ordering of the causes.\n","uniqueKey":"causes","typeLabel":"string[]"},"remedy":{"type":"string","description":"A brief description of how to resolve the problem","example":"Shorten your input to be under 100 characters","uniqueKey":"remedy","typeLabel":"string"},"supportEmail":{"type":"string","format":"email","description":"An email address to contact for support","example":"support@withampersand.com","uniqueKey":"supportEmail","typeLabel":"string\u003cemail>"},"supportPhone":{"type":"string","description":"A phone number to contact for support","example":"+1-555-555-5555","uniqueKey":"supportPhone","typeLabel":"string"},"supportUrl":{"type":"string","format":"uri","description":"A URL to contact for support","example":"mailto:support@withampersand.com","uniqueKey":"supportUrl","typeLabel":"string\u003curi>"},"retryable":{"type":"boolean","description":"Whether the request can be retried","example":false,"uniqueKey":"retryable","typeLabel":"boolean"},"retryAfter":{"type":"string","format":"date-time","description":"A timestamp after which the request can be retried, formatted as RFC-3339","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"retryAfter","typeLabel":"string\u003cdate-time>"},"context":{"type":"object","description":"Additional context for the problem","additionalProperties":true,"example":{"name":"Rick Sanchez"},"uniqueKey":"context","typeLabel":"object"}},"uniqueKey":"","typeLabel":"API Problem · object"},"examples":{"Example":{"title":"Example","value":{"type":"urn:problem-type:exampleOrganization:exampleProblem","href":"https://www.belgif.be/specification/rest/api-guide/#standardized-problem-types","title":"Description of the type of problem that occurred","status":400,"detail":"Description of specific occurrence of the problem","instance":"urn:uuid:123e4567-e89b-12d3-a456-426614174000"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"17336596-ef60-41a5-9799-1b9c5a164c47":{"APIKeyHeader":{"type":"apiKey","name":"X-Api-Key","in":"header","scopes":[],"schemeName":"APIKeyHeader"}},"c8875d4b-1bf3-448c-8f78-777a84b34792":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"}}},"servers":{"206ff708-4056-46c3-9d88-57beb150dc00":{"url":"https://api.ampersand.ai/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"X-Api-Key","in":"header","scopes":[],"schemeName":"APIKeyHeader"},"schema":{"title":"X-Api-Key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"APIKeyHeader","name":"X-Api-Key"}],"title":"APIKeyHeader"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"platform.json"},"subdomain":"ampersand-24eb5c1a","siteName":"Ampersand","title":"Batch upsert a group of integrations - Ampersand","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-05T21:23:32.686Z","originalFileLocation":"reference/integration/batch-upsert-a-group-of-integrations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the CLI\u0026#x27;s deploy command rather than this API endpoint directly.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ampersand\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Batch upsert a group of integrations - Ampersand\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the CLI\u0026#x27;s deploy command rather than this API endpoint directly.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ampersand\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ampersand-24eb5c1a.mintlify.site/_mintlify/api/og/v2?division=Integration\u0026amp;title=Batch+upsert+a+group+of+integrations\u0026amp;description=This+endpoint+is+used+by+the+Ampersand+CLI+to+batch+upsert+integrations.+We+recommend+using+the+%5BCLI%27s+deploy+command%5D%28https%3A%2F%2Fdocs.ampersand.ai%2Fcli%2Foverview%23de\u0026amp;theme=9c317003eb22ad486143ef26\u0026amp;signature=99f24baa2e5b11b6f6518291ea100a460ba8f980a4a86f23679186fef4b4a228\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Batch upsert a group of integrations - Ampersand\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the CLI\u0026#x27;s deploy command rather than this API endpoint directly.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ampersand-24eb5c1a.mintlify.site/_mintlify/api/og/v2?division=Integration\u0026amp;title=Batch+upsert+a+group+of+integrations\u0026amp;description=This+endpoint+is+used+by+the+Ampersand+CLI+to+batch+upsert+integrations.+We+recommend+using+the+%5BCLI%27s+deploy+command%5D%28https%3A%2F%2Fdocs.ampersand.ai%2Fcli%2Foverview%23de\u0026amp;theme=9c317003eb22ad486143ef26\u0026amp;signature=99f24baa2e5b11b6f6518291ea100a460ba8f980a4a86f23679186fef4b4a228\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ampersand-24eb5c1a/IC0DrawDowD95AhT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ampersand\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1F71D6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/integration/batch-upsert-a-group-of-integrations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ampersand.ai/#organization\",\"name\":\"Ampersand\",\"url\":\"https://docs.ampersand.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ampersand-24eb5c1a/RG8xjLJNYe4ES7r7/logos/light.png?fit=max\u0026auto=format\u0026n=RG8xjLJNYe4ES7r7\u0026q=85\u0026s=7799b7c055eff93e5275bfee4335494b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ampersand.ai#website\",\"name\":\"Ampersand\",\"url\":\"https://docs.ampersand.ai\",\"publisher\":{\"@id\":\"https://docs.ampersand.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations#webpage\",\"url\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations\",\"name\":\"Batch upsert a group of integrations\",\"description\":\"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the CLI's deploy command rather than this API endpoint directly.\",\"dateModified\":\"2026-10-05T21:23:32.686Z\",\"isPartOf\":{\"@id\":\"https://docs.ampersand.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"PLATFORM API\",\"item\":\"https://docs.ampersand.ai/reference/oauth/generate-oauth-authorization-url\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Integration\",\"item\":\"https://docs.ampersand.ai/reference/integration/list-integrations\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Batch upsert a group of integrations\",\"item\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations#apireference\",\"headline\":\"Batch upsert a group of integrations\",\"name\":\"Batch upsert a group of integrations\",\"description\":\"This endpoint is used by the Ampersand CLI to batch upsert integrations. We recommend using the CLI's deploy command rather than this API endpoint directly.\",\"url\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ampersand.ai/reference/integration/batch-upsert-a-group-of-integrations#webpage\"},\"dateModified\":\"2026-10-05T21:23:32.686Z\",\"publisher\":{\"@id\":\"https://docs.ampersand.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ampersand.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ampersand\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ampersand\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/integration/batch-upsert-a-group-of-integrations.md","siteName":"Ampersand","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/overview"}]},{"tab":"API Reference","groups":[{"group":"Introduction","pages":[{"title":"Ampersand REST APIs: Write, Read, Platform, and Proxy","sidebarTitle":"Overview","href":"/api/overview"},{"title":"Access via API key","href":"/api/key-auth"},{"title":"Access via JWT","href":"/api/jwt-auth"}]},{"group":"WRITE API","pages":[{"group":"Write","pages":[{"openapi":"write post /projects/{projectIdOrName}/integrations/{integrationId}/objects/{objectName}","title":"Write records","href":"/reference/write/write-records"}]}]},{"group":"READ API","pages":[{"group":"Read","pages":[{"openapi":"read post /projects/{projectIdOrName}/integrations/{integrationId}/objects/{objectName}","title":"Trigger a read","href":"/reference/read/trigger-a-read"},{"openapi":"read post /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}:pause","title":"Pause reads for an installation","href":"/reference/read/pause-reads-for-an-installation"},{"openapi":"read post /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}:unpause","title":"Unpause reads for an installation","href":"/reference/read/unpause-reads-for-an-installation"},{"openapi":"read post /projects/{projectIdOrName}/integrations/{integrationId}/objects/{objectName}:deliverResults","title":"Deliver results","href":"/reference/read/deliver-results"}]}]},{"group":"SEARCH API","pages":[{"group":"Search","pages":[{"openapi":"search post /projects/{projectIdOrName}/integrations/{integrationId}","title":"Search records","href":"/reference/search/search-records"}]}]},{"group":"PLATFORM API","pages":[{"group":"OAuth","pages":[{"openapi":"platform post /oauth-connect","title":"Generate OAuth authorization URL","href":"/reference/oauth/generate-oauth-authorization-url"},{"openapi":"platform patch /projects/{projectIdOrName}/connections/{connectionId}:oauth-update","title":"Generate OAuth authorization URL for existing connection","href":"/reference/oauth/generate-oauth-authorization-url-for-existing-connection"}]},{"group":"Connection","pages":[{"openapi":"platform post /custom-auth/connect","title":"Start or continue a multi-step custom auth flow","href":"/reference/connection/start-or-continue-a-multi-step-custom-auth-flow"},{"openapi":"platform get /projects/{projectIdOrName}/connections","title":"List connections","href":"/reference/connection/list-connections"},{"openapi":"platform post /projects/{projectIdOrName}/connections:generate","title":"Generate a new connection","href":"/reference/connection/generate-a-new-connection"},{"openapi":"platform get /projects/{projectIdOrName}/connections/{connectionId}","title":"Get a connection","href":"/reference/connection/get-a-connection"},{"openapi":"platform delete /projects/{projectIdOrName}/connections/{connectionId}","title":"Delete a connection","href":"/reference/connection/delete-a-connection"},{"openapi":"platform patch /projects/{projectIdOrName}/connections/{connectionId}","title":"Update a connection.","href":"/reference/connection/update-a-connection"}]},{"group":"Project","pages":[{"openapi":"platform get /projects","title":"List projects","href":"/reference/project/list-projects"},{"openapi":"platform post /projects","title":"Create a new project","href":"/reference/project/create-a-new-project"},{"openapi":"platform get /projects/{projectIdOrName}","title":"Get a project","href":"/reference/project/get-a-project"},{"openapi":"platform patch /projects/{projectIdOrName}","title":"Update a project","href":"/reference/project/update-a-project"}]},{"group":"Provider App","pages":[{"openapi":"platform get /projects/{projectIdOrName}/provider-apps","title":"List provider apps","href":"/reference/provider-app/list-provider-apps"},{"openapi":"platform post /projects/{projectIdOrName}/provider-apps","title":"Create a new provider app","href":"/reference/provider-app/create-a-new-provider-app"},{"openapi":"platform delete /projects/{projectIdOrName}/provider-apps/{providerAppId}","title":"Delete a provider app.","href":"/reference/provider-app/delete-a-provider-app"},{"openapi":"platform patch /projects/{projectIdOrName}/provider-apps/{providerAppId}","title":"Update a provider app","href":"/reference/provider-app/update-a-provider-app"}]},{"group":"Integration","pages":[{"openapi":"platform get /projects/{projectIdOrName}/integrations","title":"List integrations","href":"/reference/integration/list-integrations"},{"openapi":"platform post /projects/{projectIdOrName}/integrations","title":"Create a new integration.","href":"/reference/integration/create-a-new-integration"},{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationIdOrName}","title":"Get an integration by ID or name","href":"/reference/integration/get-an-integration-by-id-or-name"},{"openapi":"platform delete /projects/{projectIdOrName}/integrations/{integrationIdOrName}","title":"Delete an integration","description":"Delete an integration and all its installations.","href":"/reference/integration/delete-an-integration"},{"openapi":"platform put /projects/{projectIdOrName}/integrations:batch","title":"Batch upsert a group of integrations","href":"/reference/integration/batch-upsert-a-group-of-integrations"}]},{"group":"Revision","pages":[{"openapi":"platform post /projects/{projectIdOrName}/integrations/{integrationId}/revisions","title":"Create a new revision.","description":"We recommend using the [CLI's deploy command](https://docs.ampersand.ai/cli/overview#deploy-integrations) rather than this API endpoint directly, unless you have an advanced use case.","href":"/reference/revision/create-a-new-revision"},{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationId}/revisions/{revisionId}:hydrate","title":"Get a hydrated revision","href":"/reference/revision/get-a-hydrated-revision"}]},{"group":"Installation","pages":[{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationId}/installations","title":"List installations for an integration","href":"/reference/installation/list-installations-for-an-integration"},{"openapi":"platform post /projects/{projectIdOrName}/integrations/{integrationId}/installations","title":"Create a new installation","href":"/reference/installation/create-a-new-installation"},{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}","title":"Get an installation","href":"/reference/installation/get-an-installation"},{"openapi":"platform delete /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}","title":"Delete an installation","href":"/reference/installation/delete-an-installation"},{"openapi":"platform patch /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}","title":"Update an installation","href":"/reference/installation/update-an-installation"},{"openapi":"platform patch /projects/{projectIdOrName}/integrations/{integrationId}/objects/{objectName}/config-content","title":"Update an installation object","href":"/reference/installation/update-an-installation-object"},{"openapi":"platform get /projects/{projectIdOrName}/installations","title":"List installations for a project","href":"/reference/installation/list-installations-for-a-project"}]},{"group":"Objects \u0026 Fields","pages":[{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationId}/objects/{objectName}/metadata","title":"Get object metadata via installation","href":"/reference/objects-\u0026-fields/get-object-metadata-via-installation"},{"openapi":"platform get /projects/{projectIdOrName}/providers/{provider}/objects/{objectName}/metadata","title":"Get object metadata via connection","href":"/reference/objects-\u0026-fields/get-object-metadata-via-connection"},{"openapi":"platform put /projects/{projectIdOrName}/integrations/{integrationId}/object-metadata","title":"Upsert custom fields for installation","href":"/reference/objects-\u0026-fields/upsert-custom-fields-for-installation"},{"openapi":"platform put /projects/{projectIdOrName}/providers/{provider}/object-metadata","title":"Upsert custom fields for connection","href":"/reference/objects-\u0026-fields/upsert-custom-fields-for-connection"}]},{"group":"Operation","pages":[{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}/operations","title":"List operations","href":"/reference/operation/list-operations"},{"openapi":"platform get /projects/{projectIdOrName}/integrations/{integrationId}/installations/{installationId}/objects/{objectName}/backfill-progress","title":"Get backfill progress","href":"/reference/operation/get-backfill-progress"},{"openapi":"platform get /projects/{projectIdOrName}/operations/{operationId}","title":"Get an operation","href":"/reference/operation/get-an-operation"},{"openapi":"platform get /projects/{projectIdOrName}/operations/{operationId}/logs","title":"List logs for an operation","href":"/reference/operation/list-logs-for-an-operation"}]},{"group":"Provider","pages":[{"openapi":"platform get /providers","title":"List providers","href":"/reference/provider/list-providers"},{"openapi":"platform get /providers/{provider}","title":"Get provider","href":"/reference/provider/get-provider"}]},{"group":"API Key","pages":[{"openapi":"platform get /projects/{projectIdOrName}/api-keys","title":"List API keys","href":"/reference/api-key/list-api-keys"},{"openapi":"platform post /projects/{projectIdOrName}/api-keys","title":"Create a new API key","href":"/reference/api-key/create-a-new-api-key"},{"openapi":"platform get /projects/{projectIdOrName}/api-keys/{apiKey}","title":"Get an API key","href":"/reference/api-key/get-an-api-key"},{"openapi":"platform delete /projects/{projectIdOrName}/api-keys/{apiKey}","title":"Delete an API key","href":"/reference/api-key/delete-an-api-key"},{"openapi":"platform patch /projects/{projectIdOrName}/api-keys/{apiKey}","title":"Update an API key","href":"/reference/api-key/update-an-api-key"}]},{"group":"Destination","pages":[{"openapi":"platform get /projects/{projectIdOrName}/destinations","title":"List destinations","href":"/reference/destination/list-destinations"},{"openapi":"platform post /projects/{projectIdOrName}/destinations","title":"Create a new destination","href":"/reference/destination/create-a-new-destination"},{"openapi":"platform get /projects/{projectIdOrName}/destinations/{destination}","title":"Get a destination","href":"/reference/destination/get-a-destination"},{"openapi":"platform delete /projects/{projectIdOrName}/destinations/{destination}","title":"Delete a destination","href":"/reference/destination/delete-a-destination"},{"openapi":"platform patch /projects/{projectIdOrName}/destinations/{destination}","title":"Update a destination","href":"/reference/destination/update-a-destination"},{"openapi":"platform get /projects/{projectIdOrName}/topics","title":"List topics","href":"/reference/destination/list-topics"},{"openapi":"platform post /projects/{projectIdOrName}/topics","title":"Create a topic","href":"/reference/destination/create-a-topic"},{"openapi":"platform delete /projects/{projectIdOrName}/topics/{topicId}","title":"Delete a topic","href":"/reference/destination/delete-a-topic"},{"openapi":"platform patch /projects/{projectIdOrName}/topics/{topicId}","title":"Update a topic","href":"/reference/destination/update-a-topic"},{"openapi":"platform get /projects/{projectIdOrName}/topic-destination-routes","title":"List topic destination routes","href":"/reference/destination/list-topic-destination-routes"},{"openapi":"platform post /projects/{projectIdOrName}/topic-destination-routes","title":"Create a topic destination route","href":"/reference/destination/create-a-topic-destination-route"},{"openapi":"platform delete /projects/{projectIdOrName}/topic-destination-routes/{routeId}","title":"Delete a topic destination route","href":"/reference/destination/delete-a-topic-destination-route"}]},{"group":"Upload URL","pages":[{"openapi":"platform get /generate-upload-url","title":"Generate a signed URL to upload a zip file to.","href":"/reference/upload-url/generate-a-signed-url-to-upload-a-zip-file-to"}]},{"group":"Org","pages":[{"openapi":"platform post /orgs","title":"Create a new organization","href":"/reference/org/create-a-new-organization"},{"openapi":"platform get /orgs/{orgId}","title":"Get an organization","href":"/reference/org/get-an-organization"},{"openapi":"platform patch /orgs/{orgId}","title":"Update an organization","href":"/reference/org/update-an-organization"},{"openapi":"platform get /orgs/{orgId}/builders","title":"List builders for an organization","href":"/reference/org/list-builders-for-an-organization"},{"openapi":"platform get /orgs/{orgId}/invites","title":"List invites for an organization","href":"/reference/org/list-invites-for-an-organization"},{"openapi":"platform post /orgs/{orgId}/invites","title":"Invite a user to an organization","href":"/reference/org/invite-a-user-to-an-organization"},{"openapi":"platform get /orgs/{orgId}/invites/{inviteId}","title":"Get an invite","href":"/reference/org/get-an-invite"},{"openapi":"platform delete /orgs/{orgId}/invites/{inviteId}","title":"Revoke an invite","href":"/reference/org/revoke-an-invite"},{"openapi":"platform post /orgs/{orgId}/memberships","title":"Add user to an organization","href":"/reference/org/add-user-to-an-organization"},{"openapi":"platform get /claimed-domains","title":"Check if a domain is claimed","href":"/reference/org/check-if-a-domain-is-claimed"},{"openapi":"platform post /claimed-domains","title":"Claim a domain","href":"/reference/org/claim-a-domain"},{"openapi":"platform get /orgs/{orgId}/claimed-domains","title":"List organization's claimed domains","href":"/reference/org/list-organizations-claimed-domains"}]},{"group":"User","pages":[{"openapi":"platform get /my-info","title":"Get information about the current user","href":"/reference/user/get-information-about-the-current-user"},{"openapi":"platform post /invites:accept","title":"Accept an invite","href":"/reference/user/accept-an-invite"}]},{"group":"Billing Account","pages":[{"openapi":"platform get /orgs/{orgId}/billingAccount","title":"Get the billing account for an organization","href":"/reference/billing-account/get-the-billing-account-for-an-organization"},{"openapi":"platform post /billingAccounts/{billingAccountId}/portalSession","title":"Create a portal session for a billing account","href":"/reference/billing-account/create-a-portal-session-for-a-billing-account"}]},{"group":"Notification","pages":[{"openapi":"platform get /projects/{projectIdOrName}/notification-event-topic-routes","title":"List notification event-topic routes","href":"/reference/notification/list-notification-event-topic-routes"},{"openapi":"platform post /projects/{projectIdOrName}/notification-event-topic-routes","title":"Create a notification event-topic route","href":"/reference/notification/create-a-notification-event-topic-route"},{"openapi":"platform delete /projects/{projectIdOrName}/notification-event-topic-routes/{routeId}","title":"Delete a notification event-topic route","href":"/reference/notification/delete-a-notification-event-topic-route"}]},{"group":"JWT Key","pages":[{"openapi":"platform get /projects/{projectIdOrName}/jwt-keys","title":"List JWT keys","href":"/reference/jwt-key/list-jwt-keys"},{"openapi":"platform post /projects/{projectIdOrName}/jwt-keys","title":"Create a new JWT key","href":"/reference/jwt-key/create-a-new-jwt-key"},{"openapi":"platform get /projects/{projectIdOrName}/jwt-keys/{keyId}","title":"Get a specific JWT key","href":"/reference/jwt-key/get-a-specific-jwt-key"},{"openapi":"platform delete /projects/{projectIdOrName}/jwt-keys/{keyId}","title":"Delete a JWT key","href":"/reference/jwt-key/delete-a-jwt-key"},{"openapi":"platform patch /projects/{projectIdOrName}/jwt-keys/{keyId}","title":"Update a JWT key","href":"/reference/jwt-key/update-a-jwt-key"}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/provider-guides/overview"}]},{"tab":"Troubleshooting","pages":[{"title":"Troubleshooting","href":"/troubleshooting-guides/overview"}]}]},"basePath":"","title":"Batch upsert a group of integrations - Ampersand","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}