{
"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"
}
Connection
List connections
GET
/
projects
/
{projectIdOrName}
/
connections
List connections
curl --request GET \ --url https://api.ampersand.ai/v1/projects/{projectIdOrName}/connections \ --header 'X-Api-Key: <api-key>'
{
"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"
}
{"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/connection/list-connections","slug":"/reference/connection/list-connections","pageMetadata":{"openapi":"platform get /projects/{projectIdOrName}/connections","title":"List connections","description":null,"href":"/reference/connection/list-connections"},"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 get /projects/{projectIdOrName}/connections","title":"List connections","description":null,"href":"/reference/connection/list-connections"}}},"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":"List connections","operationId":"listConnections","tags":["Connection"],"parameters":["11307597-3302-4579-b4bb-53e40b2190f3","40755bfd-4433-40e3-9950-d70ab29dd3a5","34d98af6-22e8-4ca0-848d-4fad19883c40","8f155b44-82b1-47cb-b124-452724356948"],"responses":{"200":"c7d03738-0c56-4c46-a608-481c42a06c34","404":"d5560931-1d45-4ffd-b8f1-3ebed56a0242","default":"3621bc0b-436e-4ac6-abc3-b06eac5c0b15"},"method":"get","type":"path","servers":["206ff708-4056-46c3-9d88-57beb150dc00"],"security":["17336596-ef60-41a5-9799-1b9c5a164c47","c8875d4b-1bf3-448c-8f78-777a84b34792"],"path":"/projects/{projectIdOrName}/connections","baseUrlOptions":["https://api.ampersand.ai/v1"],"title":"List connections","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"11307597-3302-4579-b4bb-53e40b2190f3":{"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"},"40755bfd-4433-40e3-9950-d70ab29dd3a5":{"name":"provider","in":"query","description":"The provider name (e.g. \"salesforce\", \"hubspot\")","schema":{"type":"string","description":"The provider name (e.g. \"salesforce\", \"hubspot\")","uniqueKey":"","typeLabel":"string"}},"34d98af6-22e8-4ca0-848d-4fad19883c40":{"name":"groupRef","in":"query","description":"The ID of the user group that has access to this installation.","example":"group-123","schema":{"type":"string","description":"The ID of the user group that has access to this installation.","uniqueKey":"","typeLabel":"string"}},"8f155b44-82b1-47cb-b124-452724356948":{"name":"consumerRef","in":"query","description":"The consumer reference.","schema":{"type":"string","description":"The consumer reference.","uniqueKey":"","typeLabel":"string"}}},"responses":{"c7d03738-0c56-4c46-a608-481c42a06c34":{"description":"List of project connections.","content":{"application/json":{"schema":{"type":"array","items":{"title":"Connection","required":["id","createTime","group","consumer","projectId","provider","authScheme","status"],"type":"object","properties":{"id":{"type":"string","description":"The connection ID.","example":"connection-123","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"},"provider":{"type":"string","description":"The SaaS provider that this Connection is for.","example":"salesforce","isRequired":true,"uniqueKey":"items.[INDEX].provider","typeLabel":"string"},"group":{"title":"Group","required":["createTime","groupName","groupRef","projectId"],"type":"object","properties":{"groupRef":{"type":"string","description":"The ID of the user group that has access to this installation.","example":"group-123","isRequired":true,"uniqueKey":"items.[INDEX].group.groupRef","typeLabel":"string"},"groupName":{"type":"string","description":"The name of the user group that has access to this installation.","example":"Super Customer","isRequired":true,"uniqueKey":"items.[INDEX].group.groupName","typeLabel":"string"},"projectId":{"type":"string","description":"The Ampersand project ID.","example":"project-456","isRequired":true,"uniqueKey":"items.[INDEX].group.projectId","typeLabel":"string"},"createTime":{"type":"string","description":"The time the group was created.","format":"date-time","example":"2023-07-13T21:34:44.816354Z","isRequired":true,"uniqueKey":"items.[INDEX].group.createTime","typeLabel":"string\u003cdate-time>"},"updateTime":{"type":"string","description":"The time the group was last updated.","format":"date-time","example":"2023-07-13T21:34:44.816354Z","uniqueKey":"items.[INDEX].group.updateTime","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"items.[INDEX].group","typeLabel":"Group · object"},"consumer":{"title":"Consumer","required":["consumerName","consumerRef","createTime","projectId"],"type":"object","properties":{"consumerRef":{"type":"string","description":"The consumer reference.","example":"consumer-123","isRequired":true,"uniqueKey":"items.[INDEX].consumer.consumerRef","typeLabel":"string"},"consumerName":{"type":"string","description":"The name of the consumer.","example":"Super Customer","isRequired":true,"uniqueKey":"items.[INDEX].consumer.consumerName","typeLabel":"string"},"projectId":{"type":"string","description":"The Ampersand project ID.","example":"project-456","isRequired":true,"uniqueKey":"items.[INDEX].consumer.projectId","typeLabel":"string"},"createTime":{"type":"string","description":"The time the consumer was created.","format":"date-time","example":"2023-07-13T21:34:44.816354Z","isRequired":true,"uniqueKey":"items.[INDEX].consumer.createTime","typeLabel":"string\u003cdate-time>"},"updateTime":{"type":"string","description":"The time the consumer was last updated.","format":"date-time","example":"2023-07-13T21:34:44.816354Z","uniqueKey":"items.[INDEX].consumer.updateTime","typeLabel":"string\u003cdate-time>"}},"isRequired":true,"uniqueKey":"items.[INDEX].consumer","typeLabel":"Consumer · object"},"createTime":{"type":"string","description":"The time the connection was created.","format":"date-time","example":"2023-07-13T21:34:44.816354Z","isRequired":true,"uniqueKey":"items.[INDEX].createTime","typeLabel":"string\u003cdate-time>"},"authScheme":{"type":"string","description":"The authentication scheme used for this connection.","example":"oauth2/authorizationCode","enum":["none","apiKey","basic","oauth2/authorizationCode","oauth2/authorizationCodePKCE","oauth2/clientCredentials","oauth2/password"],"isRequired":true,"uniqueKey":"items.[INDEX].authScheme","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"The status of the connection.\n- `created`: The connection has just been created or the access token was just refreshed.\n- `working`: The connection has successfully been used to make a request.\n- `bad_credentials`: The connection encountered credential-related issues when making a request, or when attempting to refresh the access token.\n","example":"working","enum":["created","working","bad_credentials"],"isRequired":true,"uniqueKey":"items.[INDEX].status","typeLabel":"enum\u003cstring>"},"providerApp":{"title":"Provider App","required":["clientId","createTime","id","projectId","provider"],"type":"object","properties":{"id":{"type":"string","description":"The provider app ID.","example":"provider-app-123","isRequired":true,"uniqueKey":"items.[INDEX].providerApp.id","typeLabel":"string"},"projectId":{"type":"string","description":"The Ampersand project ID.","example":"project-456","isRequired":true,"uniqueKey":"items.[INDEX].providerApp.projectId","typeLabel":"string"},"provider":{"type":"string","description":"The SaaS provider that this app connects to.","example":"salesforce","isRequired":true,"uniqueKey":"items.[INDEX].providerApp.provider","typeLabel":"string"},"clientId":{"type":"string","description":"The OAuth client ID for this app.","example":"client-id-123","isRequired":true,"uniqueKey":"items.[INDEX].providerApp.clientId","typeLabel":"string"},"createTime":{"type":"string","description":"The time the provider app was created.","format":"date-time","isRequired":true,"uniqueKey":"items.[INDEX].providerApp.createTime","typeLabel":"string\u003cdate-time>"},"externalRef":{"type":"string","description":"The ID used by the provider to identify the app (optional).","example":"external-id-123","uniqueKey":"items.[INDEX].providerApp.externalRef","typeLabel":"string"},"scopes":{"type":"array","description":"The OAuth scopes for this app.","items":{"type":"string","example":["oauth","offline","crm.read"],"uniqueKey":"items.[INDEX].providerApp.scopes.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].providerApp.scopes","typeLabel":"string[]"},"metadata":{"title":"Provider App Metadata","type":"object","description":"Provider-specific configuration that extends the standard OAuth flow.","properties":{"authQueryParams":{"type":"object","description":"Additional query parameters to include in the OAuth authorization URL (e.g., optional_scope for HubSpot).","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].providerApp.metadata.authQueryParams.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"items.[INDEX].providerApp.metadata.authQueryParams.additionalProperties","typeLabel":"string[]"},"example":{"optional_scope":["automation.sequences.read"]},"uniqueKey":"items.[INDEX].providerApp.metadata.authQueryParams","typeLabel":"object"},"providerParams":{"type":"object","description":"Provider-specific string values keyed by names (e.g., packageInstallURL for Salesforce, gcpProjectId and gcpPubSubTopicName for Gmail).","additionalProperties":{"type":"string","uniqueKey":"items.[INDEX].providerApp.metadata.providerParams.additionalProperties","typeLabel":"string"},"example":{"packageInstallURL":"https://login.salesforce.com/packaging/installPackage.apexp?p0=04t123456789","gcpProjectId":"my-gcp-project","gcpPubSubTopicName":"my-topic"},"uniqueKey":"items.[INDEX].providerApp.metadata.providerParams","typeLabel":"object"}},"uniqueKey":"items.[INDEX].providerApp.metadata","typeLabel":"Provider App Metadata · object"},"updateTime":{"type":"string","description":"The time the provider app was updated.","format":"date-time","uniqueKey":"items.[INDEX].providerApp.updateTime","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"items.[INDEX].providerApp","typeLabel":"Provider App · object"},"providerWorkspaceRef":{"type":"string","description":"If available, the identifier for the provider workspace (e.g. the Salesforce subdomain)","example":"provider-workspace-123","uniqueKey":"items.[INDEX].providerWorkspaceRef","typeLabel":"string"},"providerConsumerRef":{"type":"string","description":"If available, the ID that Salesforce/Hubspot uses to identify this user (e.g. Salesforce has IDs in the form of https://login.salesforce.com/id/00D4x0000019CQTEA2/0054x000000orJ4AA)","example":"provider-consumer-123","uniqueKey":"items.[INDEX].providerConsumerRef","typeLabel":"string"},"updateTime":{"type":"string","description":"The time the connection was last updated.","format":"date-time","example":"2023-07-13T21:34:44.816354Z","uniqueKey":"items.[INDEX].updateTime","typeLabel":"string\u003cdate-time>"},"oauth2AuthorizationCode":{"title":"OAuth2 AuthorizationCode Token","type":"object","properties":{"accessToken":{"type":"object","required":["token"],"description":"The access token for the connection.","properties":{"token":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].oauth2AuthorizationCode.accessToken.token","typeLabel":"string"},"issuedAt":{"type":"string","format":"date-time","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"items.[INDEX].oauth2AuthorizationCode.accessToken.issuedAt","typeLabel":"string\u003cdate-time>"},"expiresAt":{"type":"string","format":"date-time","example":"2024-10-22T18:55:28.456076Z","uniqueKey":"items.[INDEX].oauth2AuthorizationCode.accessToken.expiresAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"items.[INDEX].oauth2AuthorizationCode.accessToken","typeLabel":"object"},"refreshToken":{"type":"object","required":["token"],"description":"The refresh token to use for the connection.","properties":{"token":{"type":"string","isRequired":true,"uniqueKey":"items.[INDEX].oauth2AuthorizationCode.refreshToken.token","typeLabel":"string"},"issuedAt":{"type":"string","format":"date-time","example":"2024-04-22T18:55:28.456076Z","uniqueKey":"items.[INDEX].oauth2AuthorizationCode.refreshToken.issuedAt","typeLabel":"string\u003cdate-time>"},"expiresAt":{"type":"string","format":"date-time","example":"2024-10-22T18:55:28.456076Z","uniqueKey":"items.[INDEX].oauth2AuthorizationCode.refreshToken.expiresAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"items.[INDEX].oauth2AuthorizationCode.refreshToken","typeLabel":"object"},"scopes":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX].oauth2AuthorizationCode.scopes.items.[INDEX]","typeLabel":"string"},"description":"The scopes for the tokens.","uniqueKey":"items.[INDEX].oauth2AuthorizationCode.scopes","typeLabel":"string[]"}},"uniqueKey":"items.[INDEX].oauth2AuthorizationCode","typeLabel":"OAuth2 AuthorizationCode Token · object"},"apiKey":{"type":"string","description":"The API key used while making the connection.","example":"api-key-123","uniqueKey":"items.[INDEX].apiKey","typeLabel":"string"},"providerMetadata":{"title":"Provider Metadata","type":"object","additionalProperties":{"title":"Provider Metadata Info","type":"object","required":["value","source"],"properties":{"value":{"type":"string","description":"The value of the metadata field","example":"1234567890","isRequired":true,"uniqueKey":"items.[INDEX].providerMetadata.additionalProperties.value","typeLabel":"string"},"source":{"type":"string","description":"The source of the metadata field","enum":["input","token","provider"],"example":"input","isRequired":true,"uniqueKey":"items.[INDEX].providerMetadata.additionalProperties.source","typeLabel":"enum\u003cstring>"},"displayName":{"type":"string","description":"The human-readable name for the field","example":"Account ID","uniqueKey":"items.[INDEX].providerMetadata.additionalProperties.displayName","typeLabel":"string"}},"uniqueKey":"items.[INDEX].providerMetadata.additionalProperties","typeLabel":"Provider Metadata Info · object"},"uniqueKey":"items.[INDEX].providerMetadata","typeLabel":"Provider Metadata · object"}},"uniqueKey":"items.[INDEX]","typeLabel":"Connection · object"},"uniqueKey":"","typeLabel":"Connection · object[]"},"examples":{"Example":{"title":"Example","value":[{"id":"connection-123","projectId":"project-456","provider":"salesforce","group":{"groupRef":"group-123","groupName":"Super Customer","projectId":"project-456","createTime":"2023-07-13T21:34:44.816354Z","updateTime":"2023-07-13T21:34:44.816354Z"},"consumer":{"consumerRef":"consumer-123","consumerName":"Super Customer","projectId":"project-456","createTime":"2023-07-13T21:34:44.816354Z","updateTime":"2023-07-13T21:34:44.816354Z"},"createTime":"2023-07-13T21:34:44.816354Z","authScheme":"oauth2/authorizationCode","status":"working","providerApp":{"id":"provider-app-123","projectId":"project-456","provider":"salesforce","clientId":"client-id-123","createTime":"2023-11-07T05:31:56Z","externalRef":"external-id-123","scopes":[["oauth","offline","crm.read"]],"metadata":{"authQueryParams":{"optional_scope":["automation.sequences.read"]},"providerParams":{"packageInstallURL":"https://login.salesforce.com/packaging/installPackage.apexp?p0=04t123456789","gcpProjectId":"my-gcp-project","gcpPubSubTopicName":"my-topic"}},"updateTime":"2023-11-07T05:31:56Z"},"providerWorkspaceRef":"provider-workspace-123","providerConsumerRef":"provider-consumer-123","updateTime":"2023-07-13T21:34:44.816354Z","oauth2AuthorizationCode":{"accessToken":{"token":"\u003cstring>","issuedAt":"2024-04-22T18:55:28.456076Z","expiresAt":"2024-10-22T18:55:28.456076Z"},"refreshToken":{"token":"\u003cstring>","issuedAt":"2024-04-22T18:55:28.456076Z","expiresAt":"2024-10-22T18:55:28.456076Z"},"scopes":["\u003cstring>"]},"apiKey":"api-key-123","providerMetadata":{}}]}},"exampleType":"generated"}},"exampleType":"generated"},"d5560931-1d45-4ffd-b8f1-3ebed56a0242":{"description":"Not Found","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"},"3621bc0b-436e-4ac6-abc3-b06eac5c0b15":{"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":"List connections - Ampersand","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T23:02:43.788Z","originalFileLocation":"reference/connection/list-connections.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=\"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=\"List connections - Ampersand\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ampersand\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ampersand.ai/reference/connection/list-connections\">\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=Connection\u0026amp;title=List+connections\u0026amp;theme=9c317003eb22ad486143ef26\u0026amp;signature=ab7f893294372bac89e422bbcaf00af6f1c80c194d5dec11a40d8ab26c8263eb\">\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=\"List connections - Ampersand\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ampersand-24eb5c1a.mintlify.site/_mintlify/api/og/v2?division=Connection\u0026amp;title=List+connections\u0026amp;theme=9c317003eb22ad486143ef26\u0026amp;signature=ab7f893294372bac89e422bbcaf00af6f1c80c194d5dec11a40d8ab26c8263eb\">\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/connection/list-connections\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/connection/list-connections.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/connection/list-connections#webpage\",\"url\":\"https://docs.ampersand.ai/reference/connection/list-connections\",\"name\":\"List connections\",\"dateModified\":\"2026-11-10T23:02:43.788Z\",\"isPartOf\":{\"@id\":\"https://docs.ampersand.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ampersand.ai/reference/connection/list-connections#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ampersand.ai/reference/connection/list-connections#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\":\"Connection\",\"item\":\"https://docs.ampersand.ai/reference/connection/start-or-continue-a-multi-step-custom-auth-flow\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List connections\",\"item\":\"https://docs.ampersand.ai/reference/connection/list-connections\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ampersand.ai/reference/connection/list-connections#apireference\",\"headline\":\"List connections\",\"name\":\"List connections\",\"url\":\"https://docs.ampersand.ai/reference/connection/list-connections\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ampersand.ai/reference/connection/list-connections#webpage\"},\"dateModified\":\"2026-11-10T23:02:43.788Z\",\"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/connection/list-connections.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","description":"Drives a multi-step custom auth flow (browser redirects and/or server-side credential-exchange calls). Call it once with the flow inputs to start; if the response contains a redirect, open it, then call again with the returned sessionId and the provider's callback params to continue. Repeat until the response contains a connection. Used by the prebuilt UI components; only providers whose ProviderInfo has customOpts.multiStep present can use this endpoint.\n","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","description":"All auth schemes are supported, but for OAuth2 Authorization Code, it is recommended that you use the [/oauth-connect endpoint](https://docs.ampersand.ai/reference/oauth/generate-oauth-authorization-url) instead, unless you already have the refresh token and are importing it into Ampersand.","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","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.","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":"List connections - 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"]}