Creates a custom connector in the current project’s registry. It is owned by this project and is not available to the organization’s other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization’s plan includes. When every slot is in use the request is refused with 403 custom_connector_slot_limit_reached. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project’s latest with 422; both carry that latest version as latest_version.
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Query Parameters
expand
string | null
Comma-separated fields to resolve on the created connector, with the same tokens as the get endpoint: actions, versions, changelog, accounts_count, connector_profiles_count. Unexpanded fields are null.
Body
application/json
Exactly one of the two source-specific shapes: create from a remote MCP server url, or register a StackOne connector YAML definition.
CreateMcpConnectorRequest
CreateYamlConnectorRequest
mcp_server_url
string<uri>
required
The URL of the remote MCP server to create the connector for. The server is probed to determine how it authenticates (openly, with a static access token, or through OAuth); a server without OAuth authenticates with custom_headers instead when they are given. The connector is created without actions; its tools are added separately. A project holds one connector per server URL, compared with its query included.
Pattern: ^https?://
title
string
The display name of the connector; it also derives the connector key. Defaults to the name the MCP server reports about itself, or to the server URL hostname.
Minimum string length: 1
custom_headers
string[]
Names of the headers the MCP server expects on every request, such as an API key header. Each becomes a required secret field when an account is linked, so every account sends its own values, and the server authenticates with these headers instead of a bearer access token. Rejected for a server with OAuth, and so are header names set by the MCP transport (such as Host or Mcp-Session-Id). Only valid with mcp_server_url.
Maximum array length: 10
Minimum string length: 1
Example:
["X-API-Key", "X-MCP-Profile"]
force
enum<boolean>
Not supported when creating from an MCP server url; accepted only as false, which is a no-op.
Available options:
false
Response
The connector was created.
key
string
required
The connector key (e.g. workday).
name
string
required
The human-readable connector name (e.g. Workday).
logo_url
string
required
The URL of the connector's logo.
description
string | null
required
The connector description; null when the connector declares none.
categories
string[]
required
The categories the connector belongs to (e.g. ["hris"]).
authentication_methods
object[]
required
One-line summaries of the authentication methods the connector supports.
Show child attributes
version
string
required
The connector version.
owner
string
required
The owner of the connector.
release_stage
string
required
The release stage of the connector (e.g. ga, beta).
actions_count
integer
required
The number of actions the connector exposes to the organization; 0 when the connector does not report action counts.
events_count
integer
required
The number of event actions the connector exposes; 0 when the connector does not report event counts.
documentation_url
string | null
required
The URL of the public StackOne documentation for the connector; null when no public documentation is available.
authentication
object
required
The authentication methods the connector supports, keyed by authentication config key and then by environment. Contains field definitions, notices and OAuth metadata — never credential values.
Show child attributes
actions
object[] | null
required
The metadata of the actions the connector exposes (id, label, description, tags, required scopes…). Only resolved when expand=actions is requested; null otherwise. When connector_profile_id is supplied, the actions that profile enables come first and every action carries enabled.
Show child attributes
enabled_actions_count
integer | null
required
How many of the connector's actions the connector profile given in connector_profile_id enables, out of actions_count. Only resolved when connector_profile_id is supplied together with expand=actions; null otherwise.
event_actions
object[] | null
required
The metadata of the event actions the connector exposes. Only resolved when expand=actions is requested; null otherwise.
Show child attributes
scope_definitions
object[] | null
required
The scopes the connector declares, each with the scopes it already grants. Only resolved when expand=actions is requested; null otherwise. Empty for connectors that declare no scopes.
Show child attributes
versions
object[] | null
required
The registry versions of the connector, newest first — the version options a connector profile can be pinned to. Only resolved when expand=versions is requested; null otherwise. Empty for connectors with no registry versions.
Show child attributes
changelog
object | null
required
The connector's release history: one entry per published version, newest first, with its summary, labels, release date and affected actions. Only resolved when expand=changelog is requested, and only for StackOne's built-in Falcon connectors; null otherwise, including connectors with no published changelog.
Show child attributes
accounts_count
integer | null
The number of accounts linked to the connector in this project that are visible to you. Only resolved when expand=accounts_count is requested; null otherwise.
connector_profiles_count
integer | null
The number of connector profiles configured for the connector in this project. Only resolved when expand=connector_profiles_count is requested; null otherwise.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stackone","colors":{"primary":"#068F56","light":"#00AF66","dark":"#068F56"},"logo":{"light":"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-light-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=f08be9c0a142cb1e7fcaa23910c4bf7f","dark":"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-dark-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=b57d63594c13dee65c06a2d578927466","href":"/introduction"},"favicon":"https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/logo/favicon.png?fit=max\u0026auto=format\u0026n=EZ7nWzE-JJzhmP-C\u0026q=85\u0026s=9012a8ae6ce9a80698406b611be47925","appearance":{"default":"light"},"background":{"image":{"light":"https://mintcdn.com/stackone-60/knwbcGlYFJSeLObv/images/background/light.svg?fit=max\u0026auto=format\u0026n=knwbcGlYFJSeLObv\u0026q=85\u0026s=112166d244e990ebc0146ff96958757c","dark":"https://mintcdn.com/stackone-60/knwbcGlYFJSeLObv/images/background/dark.svg?fit=max\u0026auto=format\u0026n=knwbcGlYFJSeLObv\u0026q=85\u0026s=50ec5e23eeb91f55e78a0da97dcaeb7b"},"color":{"dark":"#1a1a1a"}},"navbar":{"links":[{"icon":"circle-question","href":"/support","label":"Support"},{"href":"https://app.stackone.com","label":"Login"},{"href":"https://www.stackone.com/demo/","label":"Book a demo"}],"primary":{"type":"button","label":"Start Free","href":"https://app.stackone.com/sign_up"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/stackonehq","twitter":"https://twitter.com/StackOneHQ"}},"seo":{"metatags":{"canonical":"https://docs.stackone.com","google-site-verification":"gYj1x4gkdSwpCGVLFVXNVOPQ_wVrePW37ZKJt3HEqys"}},"fonts":{"heading":{"family":"Sf Pro Display","source":"https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2","format":"woff2"},"body":{"family":"Inter","source":"https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"gtm":{"tagId":"GTM-NZNK37TL"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stackone-60","hasAudioNarration":false,"actualSubdomain":"stackone-60","customDomains":["docs.stackone.com"],"gitSource":{"type":"github","owner":"stackonehq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afad23a3f5f5eede31cdca1","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Connectors","count":6773},{"language":"default","tag":"Connector Catalog","count":3365},{"language":"default","tag":"Embed","count":84},{"language":"default","tag":"Platform API","count":65},{"language":"default","tag":"Features","count":48},{"language":"default","tag":"Connector Building","count":42},{"language":"default","tag":"AI Platforms","count":39},{"language":"default","tag":"Gateway","count":39},{"language":"default","tag":"Unified Actions","count":39},{"language":"default","tag":"Embed StackOne","count":36}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@stackone.com"}},"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":"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},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/stackone-60/1689b391b56fc5fb/style.css"}],"page":{"pagePath":"platform/api-reference/v2/connectors/create-a-connector","slug":"/platform/api-reference/v2/connectors/create-a-connector","pageMetadata":{"openapi":"post /v2/connectors","title":"Create a connector","description":"Creates a custom connector in the current project's registry. It is owned by this project and is not available to the organization's other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization's plan includes. When every slot is in use the request is refused with 403 `custom_connector_slot_limit_reached`. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project's latest with 422; both carry that latest version as `latest_version`.","href":"/platform/api-reference/v2/connectors/create-a-connector"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates a custom connector in the current project’s registry. It is owned by this project and is not available to the organization’s other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization’s plan includes. When every slot is in use the request is refused with 403 \", _jsx(_components.code, {\n children: \"custom_connector_slot_limit_reached\"\n }), \". New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project’s latest with 422; both carry that latest version as \", _jsx(_components.code, {\n children: \"latest_version\"\n }), \".\"]\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":{"config":{},"pageMetadata":{"openapi":"post /v2/connectors","title":"Create a connector","description":"Creates a custom connector in the current project's registry. It is owned by this project and is not available to the organization's other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization's plan includes. When every slot is in use the request is refused with 403 `custom_connector_slot_limit_reached`. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project's latest with 422; both carry that latest version as `latest_version`.","href":"/platform/api-reference/v2/connectors/create-a-connector"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/stackone-60/072d59ca3ea476f6/status-indicator.js","/_mintlify/custom/stackone-60/108e4b0e256a9ba7/connectors.js","/_mintlify/custom/stackone-60/af28b3fbb0435529/hubspot-form.js","/_mintlify/custom/stackone-60/965ecce887247b53/end-users.js"],"openApiReferenceData":{"operation":{"description":"Creates a custom connector in the current project's registry. It is owned by this project and is not available to the organization's other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization's plan includes. When every slot is in use the request is refused with 403 `custom_connector_slot_limit_reached`. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project's latest with 422; both carry that latest version as `latest_version`.","operationId":"create_connector","parameters":["d9c98fc1-9243-41f4-ac46-227416f855dc"],"requestBody":"4ac60811-65ad-4b3a-ae02-e6d104645abd","responses":{"201":"2e559c34-4885-4220-8d8d-0ebcd0a6dfbb","400":"d193cac2-7e61-429d-b4a2-4ee01c7c0b13","401":"7e528506-b061-46ae-8565-4042774def66","403":"966f846d-0285-483d-839e-b825202eb2e3","404":"7760ee2c-ce8a-4f3e-9a0b-d582a313ea9e","408":"0fe8a4ae-5c67-4ada-9d1a-e447bf52db9e","409":"99d949fe-663a-4b40-9688-39accf7fafda","422":"4a8969bb-e827-487c-b090-f732b9c102cb","429":"fc47d845-4ed8-4bd0-9cb3-d51cf76b8958","500":"94b27f1b-2765-40b6-9558-9a896a72462d","501":"b5d7697b-fc37-4d92-ac61-224807efb01c","502":"f577065e-5669-49d1-99ef-d0841a40e5b4"},"security":["c69e9335-0b07-4edd-a8c7-68ea6773a7a2"],"summary":"Create a connector","tags":["Connectors"],"method":"post","type":"path","servers":["bb7cb5c7-4e06-477b-b1ef-1d5d4ba46c54"],"path":"/v2/connectors","baseUrlOptions":["https://api.stackone.com"],"title":"Create a connector","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d9c98fc1-9243-41f4-ac46-227416f855dc":{"name":"expand","required":false,"in":"query","description":"Comma-separated fields to resolve on the created connector, with the same tokens as the get endpoint: `actions`, `versions`, `changelog`, `accounts_count`, `connector_profiles_count`. Unexpanded fields are `null`.","schema":{"oneOf":[{"type":"string","description":"Comma-separated fields to resolve on the created connector, with the same tokens as the get endpoint: `actions`, `versions`, `changelog`, `accounts_count`, `connector_profiles_count`. Unexpanded fields are `null`.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","description":"Comma-separated fields to resolve on the created connector, with the same tokens as the get endpoint: `actions`, `versions`, `changelog`, `accounts_count`, `connector_profiles_count`. Unexpanded fields are `null`.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"required":true,"description":"Exactly one of the two source-specific shapes: create from a remote MCP server url, or register a StackOne connector YAML definition.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"CreateMcpConnectorRequest","required":["mcp_server_url"],"properties":{"mcp_server_url":{"type":"string","format":"uri","pattern":"^https?://","description":"The URL of the remote MCP server to create the connector for. The server is probed to determine how it authenticates (openly, with a static access token, or through OAuth); a server without OAuth authenticates with `custom_headers` instead when they are given. The connector is created without actions; its tools are added separately. A project holds one connector per server URL, compared with its query included.","isRequired":true,"uniqueKey":"oneOf.0.mcp_server_url","typeLabel":"string\u003curi>"},"title":{"type":"string","minLength":1,"description":"The display name of the connector; it also derives the connector key. Defaults to the name the MCP server reports about itself, or to the server URL hostname.","uniqueKey":"oneOf.0.title","typeLabel":"string"},"custom_headers":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"uniqueKey":"oneOf.0.custom_headers.items.[INDEX]","typeLabel":"string"},"example":["X-API-Key","X-MCP-Profile"],"description":"Names of the headers the MCP server expects on every request, such as an API key header. Each becomes a required secret field when an account is linked, so every account sends its own values, and the server authenticates with these headers instead of a bearer access token. Rejected for a server with OAuth, and so are header names set by the MCP transport (such as Host or Mcp-Session-Id). Only valid with `mcp_server_url`.","uniqueKey":"oneOf.0.custom_headers","typeLabel":"string[]"},"force":{"type":"boolean","enum":[false],"description":"Not supported when creating from an MCP server url; accepted only as `false`, which is a no-op.","uniqueKey":"oneOf.0.force","typeLabel":"enum\u003cboolean>"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"CreateMcpConnectorRequest · object"},{"type":"object","title":"CreateYamlConnectorRequest","required":["yaml"],"properties":{"yaml":{"type":"string","minLength":1,"description":"The StackOne connector YAML definition to register. Its version must be new and semver-greater than the latest one, unless `force` is set.","isRequired":true,"uniqueKey":"oneOf.1.yaml","typeLabel":"string"},"force":{"type":"boolean","default":false,"description":"Skips the version-increment validation when re-registering a connector (version conflicts are still rejected while the project has immutable versioning on, its default).","uniqueKey":"oneOf.1.force","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"CreateYamlConnectorRequest · object"}],"uniqueKey":"","typeLabel":"CreateMcpConnectorRequest · object | CreateYamlConnectorRequest · object"},"examples":{"Example":{"title":"Example","value":{"mcp_server_url":"\u003cstring>","title":"\u003cstring>","custom_headers":["X-API-Key","X-MCP-Profile"],"force":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"2e559c34-4885-4220-8d8d-0ebcd0a6dfbb":{"description":"The connector was created.","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","description":"The connector key (e.g. `workday`).","isRequired":true,"uniqueKey":"key","typeLabel":"string"},"name":{"type":"string","description":"The human-readable connector name (e.g. `Workday`).","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"logo_url":{"type":"string","description":"The URL of the connector's logo.","isRequired":true,"uniqueKey":"logo_url","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"The connector description; `null` when the connector declares none.","isRequired":true,"uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The connector description; `null` when the connector declares none.","isRequired":true,"uniqueKey":"description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"description","typeLabel":"string | null"},"categories":{"description":"The categories the connector belongs to (e.g. `[\"hris\"]`).","type":"array","items":{"type":"string","uniqueKey":"categories.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"categories","typeLabel":"string[]"},"authentication_methods":{"description":"One-line summaries of the authentication methods the connector supports.","type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The key of the authentication method (e.g. `oauth2`).","isRequired":true,"uniqueKey":"authentication_methods.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"The display label of the method (e.g. `OAuth v2`).","isRequired":true,"uniqueKey":"authentication_methods.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `oidc`, `custom`).","isRequired":true,"uniqueKey":"authentication_methods.items.[INDEX].type","typeLabel":"string"}},"required":["key","label","type"],"uniqueKey":"authentication_methods.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"authentication_methods","typeLabel":"object[]"},"version":{"type":"string","description":"The connector version.","isRequired":true,"uniqueKey":"version","typeLabel":"string"},"owner":{"type":"string","description":"The owner of the connector.","isRequired":true,"uniqueKey":"owner","typeLabel":"string"},"release_stage":{"type":"string","description":"The release stage of the connector (e.g. `ga`, `beta`).","isRequired":true,"uniqueKey":"release_stage","typeLabel":"string"},"actions_count":{"type":"integer","description":"The number of actions the connector exposes to the organization; 0 when the connector does not report action counts.","isRequired":true,"uniqueKey":"actions_count","typeLabel":"integer"},"events_count":{"type":"integer","description":"The number of event actions the connector exposes; 0 when the connector does not report event counts.","isRequired":true,"uniqueKey":"events_count","typeLabel":"integer"},"documentation_url":{"oneOf":[{"type":"string","description":"The URL of the public StackOne documentation for the connector; `null` when no public documentation is available.","isRequired":true,"uniqueKey":"documentation_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The URL of the public StackOne documentation for the connector; `null` when no public documentation is available.","isRequired":true,"uniqueKey":"documentation_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"documentation_url","typeLabel":"string | null"},"authentication":{"type":"object","additionalProperties":{"type":"object","description":"The environments of the authentication method (`default` plus concrete environments such as `production`), keyed by environment.","additionalProperties":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (`oauth2`, `oidc` or `custom`).","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.type","typeLabel":"string"},"label":{"oneOf":[{"type":"string","description":"The display label of the method (present on the `default` environment).","uniqueKey":"authentication.additionalProperties.additionalProperties.label.oneOf.0","typeLabel":"string"},{"type":"null","description":"The display label of the method (present on the `default` environment).","uniqueKey":"authentication.additionalProperties.additionalProperties.label.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.label","typeLabel":"string | null"},"envLabel":{"oneOf":[{"type":"string","description":"The display label of the environment (present on concrete environments).","uniqueKey":"authentication.additionalProperties.additionalProperties.envLabel.oneOf.0","typeLabel":"string"},{"type":"null","description":"The display label of the environment (present on concrete environments).","uniqueKey":"authentication.additionalProperties.additionalProperties.envLabel.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.envLabel","typeLabel":"string | null"},"guide":{"oneOf":[{"type":"object","description":"The guide attached to the method.","properties":{"description":{"oneOf":[{"type":"string","description":"A description of the method.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"A description of the method.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.description","typeLabel":"string | null"},"supportLink":{"oneOf":[{"type":"string","description":"A link to the setup documentation for the method.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.supportLink.oneOf.0","typeLabel":"string"},{"type":"null","description":"A link to the setup documentation for the method.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.supportLink.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.supportLink","typeLabel":"string | null"},"setup":{"oneOf":[{"type":"object","description":"The steps to set up a connector profile for the method.","required":["sections"],"properties":{"sections":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The section title.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].title","typeLabel":"string"},"content":{"type":"string","description":"The section introduction, in Markdown.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].content","typeLabel":"string"},"list":{"oneOf":[{"description":"Bullet points, in Markdown.","type":"array","items":{"type":"string","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].list.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].list.oneOf.0","typeLabel":"string[]"},{"description":"Bullet points, in Markdown.","type":"null","items":{"type":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].list.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].list","typeLabel":"string[] | null"},"image":{"oneOf":[{"type":"object","required":["src","alt"],"properties":{"src":{"type":"string","description":"The image path, relative to the connector.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].image.oneOf.0.src","typeLabel":"string"},"alt":{"type":"string","description":"Text describing the image.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].image.oneOf.0.alt","typeLabel":"string"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].image.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].image.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].image","typeLabel":"object | null"},"steps":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The step title.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].title","typeLabel":"string"},"content":{"type":"string","description":"The step instructions, in Markdown.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].content","typeLabel":"string"},"list":{"oneOf":[{"description":"Bullet points, in Markdown.","type":"array","items":{"type":"string","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].list.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].list.oneOf.0","typeLabel":"string[]"},{"description":"Bullet points, in Markdown.","type":"null","items":{"type":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].list.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].list","typeLabel":"string[] | null"},"image":{"oneOf":[{"type":"object","required":["src","alt"],"properties":{"src":{"type":"string","description":"The image path, relative to the connector.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].image.oneOf.0.src","typeLabel":"string"},"alt":{"type":"string","description":"Text describing the image.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].image.oneOf.0.alt","typeLabel":"string"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].image.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].image.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].image","typeLabel":"object | null"},"displayScopes":{"oneOf":[{"type":"boolean","description":"Whether the step shows the scopes the selected actions need.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].displayScopes.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the step shows the scopes the selected actions need.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].displayScopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].displayScopes","typeLabel":"boolean | null"},"applicableScopes":{"oneOf":[{"description":"The scopes this step covers.","type":"array","items":{"type":"string","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].applicableScopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].applicableScopes.oneOf.0","typeLabel":"string[]"},{"description":"The scopes this step covers.","type":"null","items":{"type":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].applicableScopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX].applicableScopes","typeLabel":"string[] | null"}},"required":["title","content"],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"title":{"type":"string","description":"The step title."},"content":{"type":"string","description":"The step instructions, in Markdown."},"list":{"oneOf":[{"description":"Bullet points, in Markdown.","type":"array","items":{"type":"string"}},{"description":"Bullet points, in Markdown.","type":"null","items":{"type":"string"}}]},"image":{"oneOf":[{"type":"object","required":["src","alt"],"properties":{"src":{"type":"string","description":"The image path, relative to the connector."},"alt":{"type":"string","description":"Text describing the image."}}},{"type":"null"}]},"displayScopes":{"oneOf":[{"type":"boolean","description":"Whether the step shows the scopes the selected actions need."},{"type":"null","description":"Whether the step shows the scopes the selected actions need."}]},"applicableScopes":{"oneOf":[{"description":"The scopes this step covers.","type":"array","items":{"type":"string"}},{"description":"The scopes this step covers.","type":"null","items":{"type":"string"}}]}},"required":["title","content"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].steps","typeLabel":"object[] | null"},"applicableScopes":{"oneOf":[{"description":"The scopes this section covers.","type":"array","items":{"type":"string","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].applicableScopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].applicableScopes.oneOf.0","typeLabel":"string[]"},{"description":"The scopes this section covers.","type":"null","items":{"type":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].applicableScopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX].applicableScopes","typeLabel":"string[] | null"}},"required":["title","content"],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.sections","typeLabel":"object[]"},"warning":{"oneOf":[{"type":"string","description":"A prerequisite to read before the first step, in Markdown.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.warning.oneOf.0","typeLabel":"string"},{"type":"null","description":"A prerequisite to read before the first step, in Markdown.","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.warning.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0.warning","typeLabel":"string | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0.setup","typeLabel":"object | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.guide.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.guide","typeLabel":"object | null"},"setup":{"oneOf":[{"type":"object","description":"The setup fields and notices the method requires.","properties":{"fields":{"oneOf":[{"description":"The setup fields the method requires.","type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The key the field value is submitted under.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].key","typeLabel":"string"},"label":{"oneOf":[{"type":"string","description":"The display label of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].label.oneOf.0","typeLabel":"string"},{"type":"null","description":"The display label of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].label","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","description":"The input type of the field (e.g. `text`, `password`, `select`).","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"The input type of the field (e.g. `text`, `password`, `select`).","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].type","typeLabel":"string | null"},"required":{"oneOf":[{"type":"boolean","description":"Whether the field is required.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].required.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field is required.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].required.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].required","typeLabel":"boolean | null"},"secret":{"oneOf":[{"type":"boolean","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].secret.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].secret","typeLabel":"boolean | null"},"readOnly":{"oneOf":[{"type":"boolean","description":"Whether the field is read-only.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].readOnly.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field is read-only.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].readOnly.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].readOnly","typeLabel":"boolean | null"},"options":{"oneOf":[{"description":"The options of a select-type field.","type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].options.oneOf.0.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","description":"The value submitted when the option is selected.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].options.oneOf.0.items.[INDEX].value","typeLabel":"string"}},"required":["label","value"],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].options.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].options.oneOf.0","typeLabel":"object[]"},{"description":"The options of a select-type field.","type":"null","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option."},"value":{"type":"string","description":"The value submitted when the option is selected."}},"required":["label","value"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].options.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].options","typeLabel":"object[] | null"},"placeholder":{"oneOf":[{"type":"string","description":"The placeholder text of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].placeholder.oneOf.0","typeLabel":"string"},{"type":"null","description":"The placeholder text of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].placeholder.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].placeholder","typeLabel":"string | null"},"externalSystemAccountIdentifier":{"oneOf":[{"type":"boolean","description":"Whether the field value identifies the account in the external system (used for event routing).","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].externalSystemAccountIdentifier.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field value identifies the account in the external system (used for event routing).","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].externalSystemAccountIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].externalSystemAccountIdentifier","typeLabel":"boolean | null"},"value":{"oneOf":[{"type":"string","description":"The default or fixed value of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","description":"The default or fixed value of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].value","typeLabel":"string | null"},"computed":{"oneOf":[{"type":"boolean","description":"Whether the field value is computed server-side rather than user-provided.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].computed.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field value is computed server-side rather than user-provided.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].computed.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].computed","typeLabel":"boolean | null"},"guide":{"oneOf":[{"type":"object","description":"Guide texts for the field.","properties":{"tooltip":{"oneOf":[{"type":"string","description":"A short tooltip for the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0.tooltip.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short tooltip for the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0.tooltip.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0.tooltip","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"A longer description of how to fill the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"A longer description of how to fill the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0.description","typeLabel":"string | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].guide","typeLabel":"object | null"},"validation":{"oneOf":[{"type":"object","description":"The client-side validation rule for the field value, when the connector declares one.","properties":{"type":{"oneOf":[{"type":"string","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.type","typeLabel":"enum\u003cstring> | null"},"pattern":{"oneOf":[{"type":"string","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.pattern.oneOf.0","typeLabel":"string"},{"type":"null","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.pattern.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.pattern","typeLabel":"string | null"},"format":{"oneOf":[{"type":"string","description":"The expected string format.","enum":["email","url","uuid","date","datetime","uri","unmapped_value",null],"x-speakeasy-unknown-values":"allow","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.format.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.format","typeLabel":"enum\u003cstring> | null"},"errorMessage":{"oneOf":[{"type":"string","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.errorMessage.oneOf.0","typeLabel":"string"},{"type":"null","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.errorMessage.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.errorMessage","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","description":"The message shown when a legacy/static rule fails.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.error.oneOf.0","typeLabel":"string"},{"type":"null","description":"The message shown when a legacy/static rule fails.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0.error","typeLabel":"string | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX].validation","typeLabel":"object | null"}},"required":["key"],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.0","typeLabel":"object[]"},{"description":"The setup fields the method requires.","type":"null","items":{"type":"object","properties":{"key":{"type":"string","description":"The key the field value is submitted under."},"label":{"oneOf":[{"type":"string","description":"The display label of the field."},{"type":"null","description":"The display label of the field."}]},"type":{"oneOf":[{"type":"string","description":"The input type of the field (e.g. `text`, `password`, `select`)."},{"type":"null","description":"The input type of the field (e.g. `text`, `password`, `select`)."}]},"required":{"oneOf":[{"type":"boolean","description":"Whether the field is required."},{"type":"null","description":"Whether the field is required."}]},"secret":{"oneOf":[{"type":"boolean","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted."},{"type":"null","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted."}]},"readOnly":{"oneOf":[{"type":"boolean","description":"Whether the field is read-only."},{"type":"null","description":"Whether the field is read-only."}]},"options":{"oneOf":[{"description":"The options of a select-type field.","type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option."},"value":{"type":"string","description":"The value submitted when the option is selected."}},"required":["label","value"]}},{"description":"The options of a select-type field.","type":"null","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option."},"value":{"type":"string","description":"The value submitted when the option is selected."}},"required":["label","value"]}}]},"placeholder":{"oneOf":[{"type":"string","description":"The placeholder text of the field."},{"type":"null","description":"The placeholder text of the field."}]},"externalSystemAccountIdentifier":{"oneOf":[{"type":"boolean","description":"Whether the field value identifies the account in the external system (used for event routing)."},{"type":"null","description":"Whether the field value identifies the account in the external system (used for event routing)."}]},"value":{"oneOf":[{"type":"string","description":"The default or fixed value of the field."},{"type":"null","description":"The default or fixed value of the field."}]},"computed":{"oneOf":[{"type":"boolean","description":"Whether the field value is computed server-side rather than user-provided."},{"type":"null","description":"Whether the field value is computed server-side rather than user-provided."}]},"guide":{"oneOf":[{"type":"object","description":"Guide texts for the field.","properties":{"tooltip":{"oneOf":[{"type":"string","description":"A short tooltip for the field."},{"type":"null","description":"A short tooltip for the field."}]},"description":{"oneOf":[{"type":"string","description":"A longer description of how to fill the field."},{"type":"null","description":"A longer description of how to fill the field."}]}}},{"type":"null"}]},"validation":{"oneOf":[{"type":"object","description":"The client-side validation rule for the field value, when the connector declares one.","properties":{"type":{"oneOf":[{"type":"string","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow"},{"type":"null","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow"}]},"pattern":{"oneOf":[{"type":"string","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set."},{"type":"null","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set."}]},"format":{"oneOf":[{"type":"string","description":"The expected string format.","enum":["email","url","uuid","date","datetime","uri","unmapped_value",null],"x-speakeasy-unknown-values":"allow"},{"type":"null"}]},"errorMessage":{"oneOf":[{"type":"string","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted."},{"type":"null","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted."}]},"error":{"oneOf":[{"type":"string","description":"The message shown when a legacy/static rule fails."},{"type":"null","description":"The message shown when a legacy/static rule fails."}]}}},{"type":"null"}]}},"required":["key"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.fields","typeLabel":"object[] | null"},"notices":{"oneOf":[{"description":"Notices rendered alongside the setup fields.","type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The unique key of the notice.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].key","typeLabel":"string"},"type":{"type":"string","description":"The notice type (`warning` or `info`).","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].type","typeLabel":"string"},"description":{"type":"string","description":"The notice text.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].description","typeLabel":"string"},"position":{"oneOf":[{"type":"string","description":"Where the notice is rendered (`top` or `bottom`).","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].position.oneOf.0","typeLabel":"string"},{"type":"null","description":"Where the notice is rendered (`top` or `bottom`).","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].position.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].position","typeLabel":"string | null"},"anchor":{"oneOf":[{"type":"string","description":"The key of the field the notice is anchored to.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].anchor.oneOf.0","typeLabel":"string"},{"type":"null","description":"The key of the field the notice is anchored to.","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].anchor.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX].anchor","typeLabel":"string | null"}},"required":["key","type","description"],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.0","typeLabel":"object[]"},{"description":"Notices rendered alongside the setup fields.","type":"null","items":{"type":"object","properties":{"key":{"type":"string","description":"The unique key of the notice."},"type":{"type":"string","description":"The notice type (`warning` or `info`)."},"description":{"type":"string","description":"The notice text."},"position":{"oneOf":[{"type":"string","description":"Where the notice is rendered (`top` or `bottom`)."},{"type":"null","description":"Where the notice is rendered (`top` or `bottom`)."}]},"anchor":{"oneOf":[{"type":"string","description":"The key of the field the notice is anchored to."},{"type":"null","description":"The key of the field the notice is anchored to."}]}},"required":["key","type","description"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0.notices","typeLabel":"object[] | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.setup.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.setup","typeLabel":"object | null"},"fields":{"oneOf":[{"description":"The config fields of the method (rendered outside the setup section).","type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The key the field value is submitted under.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].key","typeLabel":"string"},"label":{"oneOf":[{"type":"string","description":"The display label of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].label.oneOf.0","typeLabel":"string"},{"type":"null","description":"The display label of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].label.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].label","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","description":"The input type of the field (e.g. `text`, `password`, `select`).","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"The input type of the field (e.g. `text`, `password`, `select`).","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].type","typeLabel":"string | null"},"required":{"oneOf":[{"type":"boolean","description":"Whether the field is required.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].required.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field is required.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].required.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].required","typeLabel":"boolean | null"},"secret":{"oneOf":[{"type":"boolean","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].secret.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].secret.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].secret","typeLabel":"boolean | null"},"readOnly":{"oneOf":[{"type":"boolean","description":"Whether the field is read-only.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].readOnly.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field is read-only.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].readOnly.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].readOnly","typeLabel":"boolean | null"},"options":{"oneOf":[{"description":"The options of a select-type field.","type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].options.oneOf.0.items.[INDEX].label","typeLabel":"string"},"value":{"type":"string","description":"The value submitted when the option is selected.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].options.oneOf.0.items.[INDEX].value","typeLabel":"string"}},"required":["label","value"],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].options.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].options.oneOf.0","typeLabel":"object[]"},{"description":"The options of a select-type field.","type":"null","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option."},"value":{"type":"string","description":"The value submitted when the option is selected."}},"required":["label","value"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].options.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].options","typeLabel":"object[] | null"},"placeholder":{"oneOf":[{"type":"string","description":"The placeholder text of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].placeholder.oneOf.0","typeLabel":"string"},{"type":"null","description":"The placeholder text of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].placeholder.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].placeholder","typeLabel":"string | null"},"externalSystemAccountIdentifier":{"oneOf":[{"type":"boolean","description":"Whether the field value identifies the account in the external system (used for event routing).","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].externalSystemAccountIdentifier.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field value identifies the account in the external system (used for event routing).","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].externalSystemAccountIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].externalSystemAccountIdentifier","typeLabel":"boolean | null"},"value":{"oneOf":[{"type":"string","description":"The default or fixed value of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"null","description":"The default or fixed value of the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].value.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].value","typeLabel":"string | null"},"computed":{"oneOf":[{"type":"boolean","description":"Whether the field value is computed server-side rather than user-provided.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].computed.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the field value is computed server-side rather than user-provided.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].computed.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].computed","typeLabel":"boolean | null"},"guide":{"oneOf":[{"type":"object","description":"Guide texts for the field.","properties":{"tooltip":{"oneOf":[{"type":"string","description":"A short tooltip for the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0.tooltip.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short tooltip for the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0.tooltip.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0.tooltip","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"A longer description of how to fill the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"A longer description of how to fill the field.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0.description","typeLabel":"string | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].guide","typeLabel":"object | null"},"validation":{"oneOf":[{"type":"object","description":"The client-side validation rule for the field value, when the connector declares one.","properties":{"type":{"oneOf":[{"type":"string","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.type","typeLabel":"enum\u003cstring> | null"},"pattern":{"oneOf":[{"type":"string","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.pattern.oneOf.0","typeLabel":"string"},{"type":"null","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.pattern.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.pattern","typeLabel":"string | null"},"format":{"oneOf":[{"type":"string","description":"The expected string format.","enum":["email","url","uuid","date","datetime","uri","unmapped_value",null],"x-speakeasy-unknown-values":"allow","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.format.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.format","typeLabel":"enum\u003cstring> | null"},"errorMessage":{"oneOf":[{"type":"string","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.errorMessage.oneOf.0","typeLabel":"string"},{"type":"null","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.errorMessage.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.errorMessage","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","description":"The message shown when a legacy/static rule fails.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.error.oneOf.0","typeLabel":"string"},{"type":"null","description":"The message shown when a legacy/static rule fails.","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.error.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0.error","typeLabel":"string | null"}},"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX].validation","typeLabel":"object | null"}},"required":["key"],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.0","typeLabel":"object[]"},{"description":"The config fields of the method (rendered outside the setup section).","type":"null","items":{"type":"object","properties":{"key":{"type":"string","description":"The key the field value is submitted under."},"label":{"oneOf":[{"type":"string","description":"The display label of the field."},{"type":"null","description":"The display label of the field."}]},"type":{"oneOf":[{"type":"string","description":"The input type of the field (e.g. `text`, `password`, `select`)."},{"type":"null","description":"The input type of the field (e.g. `text`, `password`, `select`)."}]},"required":{"oneOf":[{"type":"boolean","description":"Whether the field is required."},{"type":"null","description":"Whether the field is required."}]},"secret":{"oneOf":[{"type":"boolean","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted."},{"type":"null","description":"Whether the field value is a secret — submitted via `secrets` and returned redacted."}]},"readOnly":{"oneOf":[{"type":"boolean","description":"Whether the field is read-only."},{"type":"null","description":"Whether the field is read-only."}]},"options":{"oneOf":[{"description":"The options of a select-type field.","type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option."},"value":{"type":"string","description":"The value submitted when the option is selected."}},"required":["label","value"]}},{"description":"The options of a select-type field.","type":"null","items":{"type":"object","properties":{"label":{"type":"string","description":"The display label of the option."},"value":{"type":"string","description":"The value submitted when the option is selected."}},"required":["label","value"]}}]},"placeholder":{"oneOf":[{"type":"string","description":"The placeholder text of the field."},{"type":"null","description":"The placeholder text of the field."}]},"externalSystemAccountIdentifier":{"oneOf":[{"type":"boolean","description":"Whether the field value identifies the account in the external system (used for event routing)."},{"type":"null","description":"Whether the field value identifies the account in the external system (used for event routing)."}]},"value":{"oneOf":[{"type":"string","description":"The default or fixed value of the field."},{"type":"null","description":"The default or fixed value of the field."}]},"computed":{"oneOf":[{"type":"boolean","description":"Whether the field value is computed server-side rather than user-provided."},{"type":"null","description":"Whether the field value is computed server-side rather than user-provided."}]},"guide":{"oneOf":[{"type":"object","description":"Guide texts for the field.","properties":{"tooltip":{"oneOf":[{"type":"string","description":"A short tooltip for the field."},{"type":"null","description":"A short tooltip for the field."}]},"description":{"oneOf":[{"type":"string","description":"A longer description of how to fill the field."},{"type":"null","description":"A longer description of how to fill the field."}]}}},{"type":"null"}]},"validation":{"oneOf":[{"type":"object","description":"The client-side validation rule for the field value, when the connector declares one.","properties":{"type":{"oneOf":[{"type":"string","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow"},{"type":"null","enum":["html-pattern","domain","unmapped_value",null],"description":"The rule kind, set only by legacy/static connectors (`html-pattern` or `domain`); absent on Falcon connectors.","x-speakeasy-unknown-values":"allow"}]},"pattern":{"oneOf":[{"type":"string","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set."},{"type":"null","description":"A regular expression the field value must match. On Falcon connectors exactly one of `pattern` or `format` is set."}]},"format":{"oneOf":[{"type":"string","description":"The expected string format.","enum":["email","url","uuid","date","datetime","uri","unmapped_value",null],"x-speakeasy-unknown-values":"allow"},{"type":"null"}]},"errorMessage":{"oneOf":[{"type":"string","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted."},{"type":"null","description":"The message shown when a Falcon rule fails; clients generate a fallback when omitted."}]},"error":{"oneOf":[{"type":"string","description":"The message shown when a legacy/static rule fails."},{"type":"null","description":"The message shown when a legacy/static rule fails."}]}}},{"type":"null"}]}},"required":["key"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.fields.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.fields","typeLabel":"object[] | null"},"notices":{"oneOf":[{"description":"Notices rendered alongside the config fields.","type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The unique key of the notice.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].key","typeLabel":"string"},"type":{"type":"string","description":"The notice type (`warning` or `info`).","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].type","typeLabel":"string"},"description":{"type":"string","description":"The notice text.","isRequired":true,"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].description","typeLabel":"string"},"position":{"oneOf":[{"type":"string","description":"Where the notice is rendered (`top` or `bottom`).","uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].position.oneOf.0","typeLabel":"string"},{"type":"null","description":"Where the notice is rendered (`top` or `bottom`).","uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].position.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].position","typeLabel":"string | null"},"anchor":{"oneOf":[{"type":"string","description":"The key of the field the notice is anchored to.","uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].anchor.oneOf.0","typeLabel":"string"},{"type":"null","description":"The key of the field the notice is anchored to.","uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].anchor.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX].anchor","typeLabel":"string | null"}},"required":["key","type","description"],"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.0","typeLabel":"object[]"},{"description":"Notices rendered alongside the config fields.","type":"null","items":{"type":"object","properties":{"key":{"type":"string","description":"The unique key of the notice."},"type":{"type":"string","description":"The notice type (`warning` or `info`)."},"description":{"type":"string","description":"The notice text."},"position":{"oneOf":[{"type":"string","description":"Where the notice is rendered (`top` or `bottom`)."},{"type":"null","description":"Where the notice is rendered (`top` or `bottom`)."}]},"anchor":{"oneOf":[{"type":"string","description":"The key of the field the notice is anchored to."},{"type":"null","description":"The key of the field the notice is anchored to."}]}},"required":["key","type","description"]},"uniqueKey":"authentication.additionalProperties.additionalProperties.notices.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.notices","typeLabel":"object[] | null"},"configuredTestActionIds":{"oneOf":[{"description":"The ids of the test actions configured for the method.","type":"array","items":{"type":"string","uniqueKey":"authentication.additionalProperties.additionalProperties.configuredTestActionIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.configuredTestActionIds.oneOf.0","typeLabel":"string[]"},{"description":"The ids of the test actions configured for the method.","type":"null","items":{"type":"string"},"uniqueKey":"authentication.additionalProperties.additionalProperties.configuredTestActionIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.configuredTestActionIds","typeLabel":"string[] | null"},"credentialsVerifiedByAuth":{"oneOf":[{"type":"boolean","description":"Whether completing the authentication flow already verifies credentials.","uniqueKey":"authentication.additionalProperties.additionalProperties.credentialsVerifiedByAuth.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether completing the authentication flow already verifies credentials.","uniqueKey":"authentication.additionalProperties.additionalProperties.credentialsVerifiedByAuth.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.credentialsVerifiedByAuth","typeLabel":"boolean | null"},"hasInlineTestAction":{"oneOf":[{"type":"boolean","description":"Whether the method declares an inline test action.","uniqueKey":"authentication.additionalProperties.additionalProperties.hasInlineTestAction.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the method declares an inline test action.","uniqueKey":"authentication.additionalProperties.additionalProperties.hasInlineTestAction.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.hasInlineTestAction","typeLabel":"boolean | null"},"mcpServerUrl":{"oneOf":[{"type":"string","description":"The remote MCP server an MCP method connects to, with userinfo dropped and query values masked. Present on concrete environments of MCP methods.","uniqueKey":"authentication.additionalProperties.additionalProperties.mcpServerUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The remote MCP server an MCP method connects to, with userinfo dropped and query values masked. Present on concrete environments of MCP methods.","uniqueKey":"authentication.additionalProperties.additionalProperties.mcpServerUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"authentication.additionalProperties.additionalProperties.mcpServerUrl","typeLabel":"string | null"}},"required":["type"],"uniqueKey":"authentication.additionalProperties.additionalProperties","typeLabel":"object"},"uniqueKey":"authentication.additionalProperties","typeLabel":"object"},"description":"The authentication methods the connector supports, keyed by authentication config key and then by environment. Contains field definitions, notices and OAuth metadata — never credential values.","isRequired":true,"uniqueKey":"authentication","typeLabel":"object"},"actions":{"oneOf":[{"description":"The metadata of the actions the connector exposes (id, label, description, tags, required scopes…). Only resolved when `expand=actions` is requested; `null` otherwise. When `connector_profile_id` is supplied, the actions that profile enables come first and every action carries `enabled`.","type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique id of the action.","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","description":"The display label of the action.","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].label","typeLabel":"string"},"description":{"type":"string","description":"The description of the action.","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].description","typeLabel":"string"},"schema_type":{"type":"string","description":"The schema type of the action (e.g. `list`, `create`).","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].schema_type","typeLabel":"string"},"authentication":{"description":"The authentication methods the action supports.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `custom`).","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].type","typeLabel":"string"},"label":{"type":"string","description":"The display label of the authentication method.","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].label","typeLabel":"string"},"key":{"type":"string","description":"The key of the authentication method.","isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].key","typeLabel":"string"},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires under this method.","type":"array","items":{"type":"string","uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].required_scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].required_scopes.oneOf.0","typeLabel":"string[]"},{"description":"The provider scopes the action requires under this method.","type":"null","items":{"type":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].required_scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].required_scopes","typeLabel":"string[] | null"},"description":{"oneOf":[{"type":"string","description":"A description of the authentication requirements.","uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","description":"A description of the authentication requirements.","uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX].description","typeLabel":"string | null"}},"required":["type","label","key"],"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"actions.oneOf.0.items.[INDEX].authentication","typeLabel":"object[]"},"tags":{"oneOf":[{"description":"The tags of the action.","type":"array","items":{"type":"string","uniqueKey":"actions.oneOf.0.items.[INDEX].tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].tags.oneOf.0","typeLabel":"string[]"},{"description":"The tags of the action.","type":"null","items":{"type":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].tags","typeLabel":"string[] | null"},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires.","type":"array","items":{"type":"string","uniqueKey":"actions.oneOf.0.items.[INDEX].required_scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].required_scopes.oneOf.0","typeLabel":"string[]"},{"description":"The provider scopes the action requires.","type":"null","items":{"type":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].required_scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].required_scopes","typeLabel":"string[] | null"},"release_stage":{"oneOf":[{"type":"string","description":"The release stage of the action (e.g. `ga`, `beta`).","uniqueKey":"actions.oneOf.0.items.[INDEX].release_stage.oneOf.0","typeLabel":"string"},{"type":"null","description":"The release stage of the action (e.g. `ga`, `beta`).","uniqueKey":"actions.oneOf.0.items.[INDEX].release_stage.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].release_stage","typeLabel":"string | null"},"effects":{"oneOf":[{"description":"The effects of the action (e.g. `read`, `write`, `delete`).","type":"array","items":{"type":"string","uniqueKey":"actions.oneOf.0.items.[INDEX].effects.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].effects.oneOf.0","typeLabel":"string[]"},{"description":"The effects of the action (e.g. `read`, `write`, `delete`).","type":"null","items":{"type":"string"},"uniqueKey":"actions.oneOf.0.items.[INDEX].effects.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].effects","typeLabel":"string[] | null"},"annotations":{"oneOf":[{"type":"object","description":"The behavioural annotations of the action.","properties":{"title":{"oneOf":[{"type":"string","description":"A human-readable title for the action.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.title.oneOf.0","typeLabel":"string"},{"type":"null","description":"A human-readable title for the action.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.title.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.title","typeLabel":"string | null"},"readOnlyHint":{"oneOf":[{"type":"boolean","description":"Whether the action does not modify the external system.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.readOnlyHint.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the action does not modify the external system.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.readOnlyHint.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.readOnlyHint","typeLabel":"boolean | null"},"destructiveHint":{"oneOf":[{"type":"boolean","description":"Whether the action may perform destructive updates.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.destructiveHint.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the action may perform destructive updates.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.destructiveHint.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.destructiveHint","typeLabel":"boolean | null"},"idempotentHint":{"oneOf":[{"type":"boolean","description":"Whether repeated calls with the same arguments have no additional effect.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.idempotentHint.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether repeated calls with the same arguments have no additional effect.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.idempotentHint.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.idempotentHint","typeLabel":"boolean | null"},"openWorldHint":{"oneOf":[{"type":"boolean","description":"Whether the action interacts with entities outside the external system.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.openWorldHint.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the action interacts with entities outside the external system.","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.openWorldHint.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0.openWorldHint","typeLabel":"boolean | null"}},"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"actions.oneOf.0.items.[INDEX].annotations.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].annotations","typeLabel":"object | null"},"action_details":{"oneOf":[{"type":"object","additionalProperties":true,"description":"The full action definition (inputs, response schema…). A large, connector-specific payload.","uniqueKey":"actions.oneOf.0.items.[INDEX].action_details.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"The full action definition (inputs, response schema…). A large, connector-specific payload.","uniqueKey":"actions.oneOf.0.items.[INDEX].action_details.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].action_details","typeLabel":"object | null"},"syncable":{"oneOf":[{"type":"boolean","description":"Whether this action can be synced by the data-sync engine.","uniqueKey":"actions.oneOf.0.items.[INDEX].syncable.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this action can be synced by the data-sync engine.","uniqueKey":"actions.oneOf.0.items.[INDEX].syncable.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].syncable","typeLabel":"boolean | null"},"supports_incremental":{"oneOf":[{"type":"boolean","description":"Whether this action supports incremental syncs (it declares an incremental strategy).","uniqueKey":"actions.oneOf.0.items.[INDEX].supports_incremental.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this action supports incremental syncs (it declares an incremental strategy).","uniqueKey":"actions.oneOf.0.items.[INDEX].supports_incremental.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].supports_incremental","typeLabel":"boolean | null"},"has_required_parameters":{"oneOf":[{"type":"boolean","description":"Whether this action requires parameters to be supplied when it is synced. Such actions cannot be linked automatically for every account — each schedule must be created with its parameter values.","uniqueKey":"actions.oneOf.0.items.[INDEX].has_required_parameters.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this action requires parameters to be supplied when it is synced. Such actions cannot be linked automatically for every account — each schedule must be created with its parameter values.","uniqueKey":"actions.oneOf.0.items.[INDEX].has_required_parameters.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].has_required_parameters","typeLabel":"boolean | null"},"lookback_default_window":{"oneOf":[{"type":"string","description":"The default lookback window for this action, as an ISO 8601 duration (e.g. `P2Y`). A new sync config starts its `lookback_start` this far before today. `null` when the action does not support lookback.","uniqueKey":"actions.oneOf.0.items.[INDEX].lookback_default_window.oneOf.0","typeLabel":"string"},{"type":"null","description":"The default lookback window for this action, as an ISO 8601 duration (e.g. `P2Y`). A new sync config starts its `lookback_start` this far before today. `null` when the action does not support lookback.","uniqueKey":"actions.oneOf.0.items.[INDEX].lookback_default_window.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].lookback_default_window","typeLabel":"string | null"},"supports_verify_deletions":{"oneOf":[{"type":"boolean","description":"Whether the action supports deletion verification, so its sync config can set `verify_deletions`.","uniqueKey":"actions.oneOf.0.items.[INDEX].supports_verify_deletions.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the action supports deletion verification, so its sync config can set `verify_deletions`.","uniqueKey":"actions.oneOf.0.items.[INDEX].supports_verify_deletions.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].supports_verify_deletions","typeLabel":"boolean | null"},"enabled":{"oneOf":[{"type":"boolean","description":"Whether the connector profile given in `connector_profile_id` enables this action. Present only when the request names a connector profile.","uniqueKey":"actions.oneOf.0.items.[INDEX].enabled.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the connector profile given in `connector_profile_id` enables this action. Present only when the request names a connector profile.","uniqueKey":"actions.oneOf.0.items.[INDEX].enabled.oneOf.1","typeLabel":"null"}],"uniqueKey":"actions.oneOf.0.items.[INDEX].enabled","typeLabel":"boolean | null"}},"required":["id","label","description","schema_type","authentication"],"uniqueKey":"actions.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"actions.oneOf.0","typeLabel":"object[]"},{"description":"The metadata of the actions the connector exposes (id, label, description, tags, required scopes…). Only resolved when `expand=actions` is requested; `null` otherwise. When `connector_profile_id` is supplied, the actions that profile enables come first and every action carries `enabled`.","type":"null","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique id of the action."},"label":{"type":"string","description":"The display label of the action."},"description":{"type":"string","description":"The description of the action."},"schema_type":{"type":"string","description":"The schema type of the action (e.g. `list`, `create`)."},"tags":{"oneOf":[{"description":"The tags of the action.","type":"array","items":{"type":"string"}},{"description":"The tags of the action.","type":"null","items":{"type":"string"}}]},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires.","type":"array","items":{"type":"string"}},{"description":"The provider scopes the action requires.","type":"null","items":{"type":"string"}}]},"release_stage":{"oneOf":[{"type":"string","description":"The release stage of the action (e.g. `ga`, `beta`)."},{"type":"null","description":"The release stage of the action (e.g. `ga`, `beta`)."}]},"effects":{"oneOf":[{"description":"The effects of the action (e.g. `read`, `write`, `delete`).","type":"array","items":{"type":"string"}},{"description":"The effects of the action (e.g. `read`, `write`, `delete`).","type":"null","items":{"type":"string"}}]},"annotations":{"oneOf":[{"type":"object","description":"The behavioural annotations of the action.","properties":{"title":{"oneOf":[{"type":"string","description":"A human-readable title for the action."},{"type":"null","description":"A human-readable title for the action."}]},"readOnlyHint":{"oneOf":[{"type":"boolean","description":"Whether the action does not modify the external system."},{"type":"null","description":"Whether the action does not modify the external system."}]},"destructiveHint":{"oneOf":[{"type":"boolean","description":"Whether the action may perform destructive updates."},{"type":"null","description":"Whether the action may perform destructive updates."}]},"idempotentHint":{"oneOf":[{"type":"boolean","description":"Whether repeated calls with the same arguments have no additional effect."},{"type":"null","description":"Whether repeated calls with the same arguments have no additional effect."}]},"openWorldHint":{"oneOf":[{"type":"boolean","description":"Whether the action interacts with entities outside the external system."},{"type":"null","description":"Whether the action interacts with entities outside the external system."}]}}},{"type":"null"}]},"action_details":{"oneOf":[{"type":"object","additionalProperties":true,"description":"The full action definition (inputs, response schema…). A large, connector-specific payload."},{"type":"null","additionalProperties":true,"description":"The full action definition (inputs, response schema…). A large, connector-specific payload."}]},"authentication":{"description":"The authentication methods the action supports.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `custom`)."},"label":{"type":"string","description":"The display label of the authentication method."},"key":{"type":"string","description":"The key of the authentication method."},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires under this method.","type":"array","items":{"type":"string"}},{"description":"The provider scopes the action requires under this method.","type":"null","items":{"type":"string"}}]},"description":{"oneOf":[{"type":"string","description":"A description of the authentication requirements."},{"type":"null","description":"A description of the authentication requirements."}]}},"required":["type","label","key"]}},"syncable":{"oneOf":[{"type":"boolean","description":"Whether this action can be synced by the data-sync engine."},{"type":"null","description":"Whether this action can be synced by the data-sync engine."}]},"supports_incremental":{"oneOf":[{"type":"boolean","description":"Whether this action supports incremental syncs (it declares an incremental strategy)."},{"type":"null","description":"Whether this action supports incremental syncs (it declares an incremental strategy)."}]},"has_required_parameters":{"oneOf":[{"type":"boolean","description":"Whether this action requires parameters to be supplied when it is synced. Such actions cannot be linked automatically for every account — each schedule must be created with its parameter values."},{"type":"null","description":"Whether this action requires parameters to be supplied when it is synced. Such actions cannot be linked automatically for every account — each schedule must be created with its parameter values."}]},"lookback_default_window":{"oneOf":[{"type":"string","description":"The default lookback window for this action, as an ISO 8601 duration (e.g. `P2Y`). A new sync config starts its `lookback_start` this far before today. `null` when the action does not support lookback."},{"type":"null","description":"The default lookback window for this action, as an ISO 8601 duration (e.g. `P2Y`). A new sync config starts its `lookback_start` this far before today. `null` when the action does not support lookback."}]},"supports_verify_deletions":{"oneOf":[{"type":"boolean","description":"Whether the action supports deletion verification, so its sync config can set `verify_deletions`."},{"type":"null","description":"Whether the action supports deletion verification, so its sync config can set `verify_deletions`."}]},"enabled":{"oneOf":[{"type":"boolean","description":"Whether the connector profile given in `connector_profile_id` enables this action. Present only when the request names a connector profile."},{"type":"null","description":"Whether the connector profile given in `connector_profile_id` enables this action. Present only when the request names a connector profile."}]}},"required":["id","label","description","schema_type","authentication"]},"isRequired":true,"uniqueKey":"actions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"actions","typeLabel":"object[] | null"},"enabled_actions_count":{"oneOf":[{"type":"integer","description":"How many of the connector's actions the connector profile given in `connector_profile_id` enables, out of `actions_count`. Only resolved when `connector_profile_id` is supplied together with `expand=actions`; `null` otherwise.","isRequired":true,"uniqueKey":"enabled_actions_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"How many of the connector's actions the connector profile given in `connector_profile_id` enables, out of `actions_count`. Only resolved when `connector_profile_id` is supplied together with `expand=actions`; `null` otherwise.","isRequired":true,"uniqueKey":"enabled_actions_count.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"enabled_actions_count","typeLabel":"integer | null"},"event_actions":{"oneOf":[{"description":"The metadata of the event actions the connector exposes. Only resolved when `expand=actions` is requested; `null` otherwise.","type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique id of the event action.","isRequired":true,"uniqueKey":"event_actions.oneOf.0.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","description":"The display label of the event action.","isRequired":true,"uniqueKey":"event_actions.oneOf.0.items.[INDEX].label","typeLabel":"string"},"description":{"type":"string","description":"The description of the event action.","isRequired":true,"uniqueKey":"event_actions.oneOf.0.items.[INDEX].description","typeLabel":"string"},"tags":{"oneOf":[{"description":"The tags of the event action.","type":"array","items":{"type":"string","uniqueKey":"event_actions.oneOf.0.items.[INDEX].tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"event_actions.oneOf.0.items.[INDEX].tags.oneOf.0","typeLabel":"string[]"},{"description":"The tags of the event action.","type":"null","items":{"type":"string"},"uniqueKey":"event_actions.oneOf.0.items.[INDEX].tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].tags","typeLabel":"string[] | null"},"release_stage":{"oneOf":[{"type":"string","description":"The release stage of the event action (e.g. `ga`, `beta`).","uniqueKey":"event_actions.oneOf.0.items.[INDEX].release_stage.oneOf.0","typeLabel":"string"},{"type":"null","description":"The release stage of the event action (e.g. `ga`, `beta`).","uniqueKey":"event_actions.oneOf.0.items.[INDEX].release_stage.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].release_stage","typeLabel":"string | null"},"requires_manual_setup":{"oneOf":[{"type":"boolean","description":"Whether the event requires manual webhook setup in the external system.","uniqueKey":"event_actions.oneOf.0.items.[INDEX].requires_manual_setup.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the event requires manual webhook setup in the external system.","uniqueKey":"event_actions.oneOf.0.items.[INDEX].requires_manual_setup.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].requires_manual_setup","typeLabel":"boolean | null"},"authentication":{"oneOf":[{"description":"The authentication methods the event action supports.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `custom`).","isRequired":true,"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].type","typeLabel":"string"},"label":{"type":"string","description":"The display label of the authentication method.","isRequired":true,"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].label","typeLabel":"string"},"key":{"type":"string","description":"The key of the authentication method.","isRequired":true,"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].key","typeLabel":"string"},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires under this method.","type":"array","items":{"type":"string","uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].required_scopes.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].required_scopes.oneOf.0","typeLabel":"string[]"},{"description":"The provider scopes the action requires under this method.","type":"null","items":{"type":"string"},"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].required_scopes.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].required_scopes","typeLabel":"string[] | null"},"description":{"oneOf":[{"type":"string","description":"A description of the authentication requirements.","uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","description":"A description of the authentication requirements.","uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX].description","typeLabel":"string | null"}},"required":["type","label","key"],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.0","typeLabel":"object[]"},{"description":"The authentication methods the event action supports.","type":"null","items":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `custom`)."},"label":{"type":"string","description":"The display label of the authentication method."},"key":{"type":"string","description":"The key of the authentication method."},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires under this method.","type":"array","items":{"type":"string"}},{"description":"The provider scopes the action requires under this method.","type":"null","items":{"type":"string"}}]},"description":{"oneOf":[{"type":"string","description":"A description of the authentication requirements."},{"type":"null","description":"A description of the authentication requirements."}]}},"required":["type","label","key"]},"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication.oneOf.1","typeLabel":"null"}],"uniqueKey":"event_actions.oneOf.0.items.[INDEX].authentication","typeLabel":"object[] | null"}},"required":["id","label","description"],"uniqueKey":"event_actions.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"event_actions.oneOf.0","typeLabel":"object[]"},{"description":"The metadata of the event actions the connector exposes. Only resolved when `expand=actions` is requested; `null` otherwise.","type":"null","items":{"type":"object","properties":{"id":{"type":"string","description":"The unique id of the event action."},"label":{"type":"string","description":"The display label of the event action."},"description":{"type":"string","description":"The description of the event action."},"tags":{"oneOf":[{"description":"The tags of the event action.","type":"array","items":{"type":"string"}},{"description":"The tags of the event action.","type":"null","items":{"type":"string"}}]},"release_stage":{"oneOf":[{"type":"string","description":"The release stage of the event action (e.g. `ga`, `beta`)."},{"type":"null","description":"The release stage of the event action (e.g. `ga`, `beta`)."}]},"requires_manual_setup":{"oneOf":[{"type":"boolean","description":"Whether the event requires manual webhook setup in the external system."},{"type":"null","description":"Whether the event requires manual webhook setup in the external system."}]},"authentication":{"oneOf":[{"description":"The authentication methods the event action supports.","type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `custom`)."},"label":{"type":"string","description":"The display label of the authentication method."},"key":{"type":"string","description":"The key of the authentication method."},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires under this method.","type":"array","items":{"type":"string"}},{"description":"The provider scopes the action requires under this method.","type":"null","items":{"type":"string"}}]},"description":{"oneOf":[{"type":"string","description":"A description of the authentication requirements."},{"type":"null","description":"A description of the authentication requirements."}]}},"required":["type","label","key"]}},{"description":"The authentication methods the event action supports.","type":"null","items":{"type":"object","properties":{"type":{"type":"string","description":"The authentication type (e.g. `oauth2`, `custom`)."},"label":{"type":"string","description":"The display label of the authentication method."},"key":{"type":"string","description":"The key of the authentication method."},"required_scopes":{"oneOf":[{"description":"The provider scopes the action requires under this method.","type":"array","items":{"type":"string"}},{"description":"The provider scopes the action requires under this method.","type":"null","items":{"type":"string"}}]},"description":{"oneOf":[{"type":"string","description":"A description of the authentication requirements."},{"type":"null","description":"A description of the authentication requirements."}]}},"required":["type","label","key"]}}]}},"required":["id","label","description"]},"isRequired":true,"uniqueKey":"event_actions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"event_actions","typeLabel":"object[] | null"},"scope_definitions":{"oneOf":[{"description":"The scopes the connector declares, each with the scopes it already grants. Only resolved when `expand=actions` is requested; `null` otherwise. Empty for connectors that declare no scopes.","type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The scope name, as it appears in `required_scopes`.","isRequired":true,"uniqueKey":"scope_definitions.oneOf.0.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"What the scope grants.","isRequired":true,"uniqueKey":"scope_definitions.oneOf.0.items.[INDEX].description","typeLabel":"string"},"includes":{"oneOf":[{"description":"The scopes this scope already grants. A consumer listing required scopes can drop any scope another listed scope includes.","type":"array","items":{"type":"string","uniqueKey":"scope_definitions.oneOf.0.items.[INDEX].includes.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"scope_definitions.oneOf.0.items.[INDEX].includes.oneOf.0","typeLabel":"string[]"},{"description":"The scopes this scope already grants. A consumer listing required scopes can drop any scope another listed scope includes.","type":"null","items":{"type":"string"},"uniqueKey":"scope_definitions.oneOf.0.items.[INDEX].includes.oneOf.1","typeLabel":"null"}],"uniqueKey":"scope_definitions.oneOf.0.items.[INDEX].includes","typeLabel":"string[] | null"}},"required":["name","description"],"uniqueKey":"scope_definitions.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"scope_definitions.oneOf.0","typeLabel":"object[]"},{"description":"The scopes the connector declares, each with the scopes it already grants. Only resolved when `expand=actions` is requested; `null` otherwise. Empty for connectors that declare no scopes.","type":"null","items":{"type":"object","properties":{"name":{"type":"string","description":"The scope name, as it appears in `required_scopes`."},"description":{"type":"string","description":"What the scope grants."},"includes":{"oneOf":[{"description":"The scopes this scope already grants. A consumer listing required scopes can drop any scope another listed scope includes.","type":"array","items":{"type":"string"}},{"description":"The scopes this scope already grants. A consumer listing required scopes can drop any scope another listed scope includes.","type":"null","items":{"type":"string"}}]}},"required":["name","description"]},"isRequired":true,"uniqueKey":"scope_definitions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"scope_definitions","typeLabel":"object[] | null"},"versions":{"oneOf":[{"description":"The registry versions of the connector, newest first — the version options a connector profile can be pinned to. Only resolved when `expand=versions` is requested; `null` otherwise. Empty for connectors with no registry versions.","type":"array","items":{"type":"object","properties":{"version":{"type":"string","description":"The connector version (e.g. `1.2.0`).","isRequired":true,"uniqueKey":"versions.oneOf.0.items.[INDEX].version","typeLabel":"string"},"owner":{"type":"string","description":"The owner of the version; `stackone` for built-in connectors.","isRequired":true,"uniqueKey":"versions.oneOf.0.items.[INDEX].owner","typeLabel":"string"},"builtin":{"type":"boolean","description":"Whether the version is a built-in StackOne connector (`true`) or one owned by the organization (`false`).","isRequired":true,"uniqueKey":"versions.oneOf.0.items.[INDEX].builtin","typeLabel":"boolean"},"release_stage":{"type":"string","description":"The release stage of the version (e.g. `ga`, `beta`).","isRequired":true,"uniqueKey":"versions.oneOf.0.items.[INDEX].release_stage","typeLabel":"string"}},"required":["version","owner","builtin","release_stage"],"uniqueKey":"versions.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"versions.oneOf.0","typeLabel":"object[]"},{"description":"The registry versions of the connector, newest first — the version options a connector profile can be pinned to. Only resolved when `expand=versions` is requested; `null` otherwise. Empty for connectors with no registry versions.","type":"null","items":{"type":"object","properties":{"version":{"type":"string","description":"The connector version (e.g. `1.2.0`)."},"owner":{"type":"string","description":"The owner of the version; `stackone` for built-in connectors."},"builtin":{"type":"boolean","description":"Whether the version is a built-in StackOne connector (`true`) or one owned by the organization (`false`)."},"release_stage":{"type":"string","description":"The release stage of the version (e.g. `ga`, `beta`)."}},"required":["version","owner","builtin","release_stage"]},"isRequired":true,"uniqueKey":"versions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"versions","typeLabel":"object[] | null"},"changelog":{"oneOf":[{"type":"object","description":"The connector's release history: one entry per published version, newest first, with its summary, labels, release date and affected actions. Only resolved when `expand=changelog` is requested, and only for StackOne's built-in Falcon connectors; `null` otherwise, including connectors with no published changelog.","required":["current_version","entries"],"properties":{"current_version":{"type":"string","description":"The most recent version with a changelog entry.","isRequired":true,"uniqueKey":"changelog.oneOf.0.current_version","typeLabel":"string"},"entries":{"description":"One entry per published version, newest first by version (semver descending).","type":"array","items":{"type":"object","properties":{"version":{"type":"string","description":"The connector version the entry describes (e.g. `1.2.0`).","isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].version","typeLabel":"string"},"summary":{"type":"string","description":"A summary of what changed in this version.","isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].summary","typeLabel":"string"},"labels":{"oneOf":[{"description":"Labels categorising the change (e.g. `new-actions`, `bug-fix`); `null` when the entry carries none.","type":"array","items":{"type":"string","uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].labels.oneOf.0.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].labels.oneOf.0","typeLabel":"string[]"},{"description":"Labels categorising the change (e.g. `new-actions`, `bug-fix`); `null` when the entry carries none.","type":"null","items":{"type":"string"},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].labels.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].labels","typeLabel":"string[] | null"},"released_at":{"type":"string","format":"date-time","description":"When the version was released, as an ISO 8601 timestamp.","isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].released_at","typeLabel":"string\u003cdate-time>"},"affected_actions":{"oneOf":[{"type":"object","description":"The action ids this version added, removed and changed relative to the previous version; `null` when no previous version exists to compare against (a connector's first recorded entry).","required":["added","removed","changed"],"properties":{"added":{"description":"The ids of the actions this version added.","type":"array","items":{"type":"string","uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0.added.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0.added","typeLabel":"string[]"},"removed":{"description":"The ids of the actions this version removed.","type":"array","items":{"type":"string","uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0.removed.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0.removed","typeLabel":"string[]"},"changed":{"description":"The ids of the actions this version changed.","type":"array","items":{"type":"string","uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0.changed.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0.changed","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX].affected_actions","typeLabel":"object | null"}},"required":["version","summary","labels","released_at","affected_actions"],"uniqueKey":"changelog.oneOf.0.entries.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"changelog.oneOf.0.entries","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"changelog.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"changelog.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"changelog","typeLabel":"object | null"},"accounts_count":{"oneOf":[{"type":"integer","description":"The number of accounts linked to the connector in this project that are visible to you. Only resolved when `expand=accounts_count` is requested; `null` otherwise.","uniqueKey":"accounts_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The number of accounts linked to the connector in this project that are visible to you. Only resolved when `expand=accounts_count` is requested; `null` otherwise.","uniqueKey":"accounts_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"accounts_count","typeLabel":"integer | null"},"connector_profiles_count":{"oneOf":[{"type":"integer","description":"The number of connector profiles configured for the connector in this project. Only resolved when `expand=connector_profiles_count` is requested; `null` otherwise.","uniqueKey":"connector_profiles_count.oneOf.0","typeLabel":"integer"},{"type":"null","description":"The number of connector profiles configured for the connector in this project. Only resolved when `expand=connector_profiles_count` is requested; `null` otherwise.","uniqueKey":"connector_profiles_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"connector_profiles_count","typeLabel":"integer | null"}},"required":["key","name","logo_url","description","categories","authentication_methods","version","owner","release_stage","actions_count","events_count","documentation_url","authentication","actions","enabled_actions_count","event_actions","scope_definitions","versions","changelog"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"key":"\u003cstring>","name":"\u003cstring>","logo_url":"\u003cstring>","description":"\u003cstring>","categories":["\u003cstring>"],"authentication_methods":[{"key":"\u003cstring>","label":"\u003cstring>","type":"\u003cstring>"}],"version":"\u003cstring>","owner":"\u003cstring>","release_stage":"\u003cstring>","actions_count":123,"events_count":123,"documentation_url":"\u003cstring>","authentication":{},"actions":[{"id":"\u003cstring>","label":"\u003cstring>","description":"\u003cstring>","schema_type":"\u003cstring>","authentication":[{"type":"\u003cstring>","label":"\u003cstring>","key":"\u003cstring>","required_scopes":["\u003cstring>"],"description":"\u003cstring>"}],"tags":["\u003cstring>"],"required_scopes":["\u003cstring>"],"release_stage":"\u003cstring>","effects":["\u003cstring>"],"annotations":{"title":"\u003cstring>","readOnlyHint":true,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"action_details":{},"syncable":true,"supports_incremental":true,"has_required_parameters":true,"lookback_default_window":"\u003cstring>","supports_verify_deletions":true,"enabled":true}],"enabled_actions_count":123,"event_actions":[{"id":"\u003cstring>","label":"\u003cstring>","description":"\u003cstring>","tags":["\u003cstring>"],"release_stage":"\u003cstring>","requires_manual_setup":true,"authentication":[{"type":"\u003cstring>","label":"\u003cstring>","key":"\u003cstring>","required_scopes":["\u003cstring>"],"description":"\u003cstring>"}]}],"scope_definitions":[{"name":"\u003cstring>","description":"\u003cstring>","includes":["\u003cstring>"]}],"versions":[{"version":"\u003cstring>","owner":"\u003cstring>","builtin":true,"release_stage":"\u003cstring>"}],"changelog":{"current_version":"\u003cstring>","entries":[{"version":"\u003cstring>","summary":"\u003cstring>","labels":["\u003cstring>"],"released_at":"2023-11-07T05:31:56Z","affected_actions":{"added":["\u003cstring>"],"removed":["\u003cstring>"],"changed":["\u003cstring>"]}}]},"accounts_count":123,"connector_profiles_count":123}}},"exampleType":"generated"}},"exampleType":"generated"},"d193cac2-7e61-429d-b4a2-4ee01c7c0b13":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Bad Request","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"data":{"oneOf":[{"type":"object","description":"Error details","properties":{"statusCode":{"oneOf":[{"type":"number","description":"HTTP status code","example":400,"uniqueKey":"data.oneOf.0.statusCode.oneOf.0","typeLabel":"number"},{"type":"null","description":"HTTP status code","example":400,"uniqueKey":"data.oneOf.0.statusCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.statusCode","typeLabel":"number | null"},"message":{"oneOf":[{"type":"string","description":"Error message","example":"Bad Request","uniqueKey":"data.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Error message","example":"Bad Request","uniqueKey":"data.oneOf.0.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.message","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"data.oneOf.0.headers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"data.oneOf.0.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.headers","typeLabel":"object | null"}},"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"},"provider_errors":{"oneOf":[{"description":"List of provider-specific errors","type":"array","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"number","description":"HTTP status code of the provider error","example":400,"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status.oneOf.0","typeLabel":"number"},{"type":"null","description":"HTTP status code of the provider error","example":400,"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status","typeLabel":"number | null"},"url":{"oneOf":[{"type":"string","description":"URL that caused the error","example":"https://api.provider.com/v1/resource","uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL that caused the error","example":"https://api.provider.com/v1/resource","uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"object","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw.oneOf.0","typeLabel":"object"},{"type":"null","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw","typeLabel":"object | null"},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers","typeLabel":"object | null"}},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"provider_errors.oneOf.0","typeLabel":"object[]"},{"description":"List of provider-specific errors","type":"null","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"number","description":"HTTP status code of the provider error","example":400},{"type":"null","description":"HTTP status code of the provider error","example":400}]},"url":{"oneOf":[{"type":"string","description":"URL that caused the error","example":"https://api.provider.com/v1/resource"},{"type":"null","description":"URL that caused the error","example":"https://api.provider.com/v1/resource"}]},"raw":{"oneOf":[{"type":"object","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"}},{"type":"null","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"}}]},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}}]}}},"uniqueKey":"provider_errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors","typeLabel":"object[] | null"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Bad Request","timestamp":"2023-05-30T00:00:00.000Z","data":{"statusCode":400,"message":"Bad Request","headers":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}},"provider_errors":[{"status":400,"url":"https://api.provider.com/v1/resource","raw":{"message":"Invalid input parameters"},"headers":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7e528506-b061-46ae-8565-4042774def66":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Unauthorized","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"message":"Unauthorized","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"966f846d-0285-483d-839e-b825202eb2e3":{"description":"Forbidden.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":403,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Forbidden resource","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":403,"message":"Forbidden resource","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"7760ee2c-ce8a-4f3e-9a0b-d582a313ea9e":{"description":"Resource not found.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":404,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Not Found","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"message":"Not Found","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"0fe8a4ae-5c67-4ada-9d1a-e447bf52db9e":{"description":"The request has timed out.","headers":{"Retry-After":{"description":"A time in seconds after which the request can be retried.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":408,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Request timed out","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":408,"message":"Request timed out","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"99d949fe-663a-4b40-9688-39accf7fafda":{"description":"Conflict with current state.\n\nThe connector already exists: a YAML connector whose version is already registered (the body then carries `latest_version`), a connector key that is taken, or an MCP server URL the project already has a connector for.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":409,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Conflict","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"latest_version":{"oneOf":[{"type":"string","description":"The project's latest version of the connector. Present when the conflict is a connector version that already exists.","example":"1.2.0","uniqueKey":"latest_version.oneOf.0","typeLabel":"string"},{"type":"null","description":"The project's latest version of the connector. Present when the conflict is a connector version that already exists.","example":"1.2.0","uniqueKey":"latest_version.oneOf.1","typeLabel":"null"}],"uniqueKey":"latest_version","typeLabel":"string | null"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":409,"message":"Conflict","timestamp":"2023-05-30T00:00:00.000Z","latest_version":"1.2.0"}}},"exampleType":"generated"}},"exampleType":"generated"},"4a8969bb-e827-487c-b090-f732b9c102cb":{"description":"Validation error.\n\nThe YAML connector's version is not greater than the project's latest version.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":422,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Unprocessable Entity","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"latest_version":{"type":"string","description":"The project's latest version of the connector, which a new version must be greater than.","example":"1.2.0","isRequired":true,"uniqueKey":"latest_version","typeLabel":"string"}},"required":["statusCode","message","timestamp","latest_version"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":422,"message":"Unprocessable Entity","timestamp":"2023-05-30T00:00:00.000Z","latest_version":"1.2.0"}}},"exampleType":"generated"}},"exampleType":"generated"},"fc47d845-4ed8-4bd0-9cb3-d51cf76b8958":{"description":"Too many requests.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":429,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Too many requests","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":429,"message":"Too many requests","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"94b27f1b-2765-40b6-9558-9a896a72462d":{"description":"Server error while executing the request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":500,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Internal server error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":500,"message":"Internal server error","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"b5d7697b-fc37-4d92-ac61-224807efb01c":{"description":"This functionality is not implemented.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":501,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Not Implemented","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":501,"message":"Not Implemented","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"f577065e-5669-49d1-99ef-d0841a40e5b4":{"description":"Bad gateway error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":502,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Bad Gateway","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":502,"message":"Bad Gateway","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"c69e9335-0b07-4edd-a8c7-68ea6773a7a2":{"basic":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basic"}}},"servers":{"bb7cb5c7-4e06-477b-b1ef-1d5d4ba46c54":{"url":"https://api.stackone.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basic"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basic","name":"Authorization"}],"title":"basic"}]},"originalFileLocation":"platform/api-reference/platform-v2.json"},"subdomain":"stackone-60","siteName":"Stackone","title":"Create a connector - Stackone","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T10:30:56.206Z","originalFileLocation":"platform/api-reference/v2/connectors/create-a-connector.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=\"light\"}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=\"Creates a custom connector in the current project\u0026#x27;s registry. It is owned by this project and is not available to the organization\u0026#x27;s other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization\u0026#x27;s plan includes. When every slot is in use the request is refused with 403 custom_connector_slot_limit_reached. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project\u0026#x27;s latest with 422; both carry that latest version as latest_version.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stackone\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a connector - Stackone\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a custom connector in the current project\u0026#x27;s registry. It is owned by this project and is not available to the organization\u0026#x27;s other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization\u0026#x27;s plan includes. When every slot is in use the request is refused with 403 custom_connector_slot_limit_reached. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project\u0026#x27;s latest with 422; both carry that latest version as latest_version.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stackone\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stackone-60.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Create+a+connector\u0026amp;description=Creates+a+custom+connector+in+the+current+project%27s+registry.+It+is+owned+by+this+project+and+is+not+available+to+the+organization%27s+other+projects.+A+YAML+conn\u0026amp;theme=26a0c4b0d3b33d43a09092cd\u0026amp;signature=1e989894d9c8795fa04adc4f8a4f08b4d3e573e25a36284d262f9952cc4b5b58\">\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=\"Create a connector - Stackone\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a custom connector in the current project\u0026#x27;s registry. It is owned by this project and is not available to the organization\u0026#x27;s other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization\u0026#x27;s plan includes. When every slot is in use the request is refused with 403 custom_connector_slot_limit_reached. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project\u0026#x27;s latest with 422; both carry that latest version as latest_version.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stackone-60.mintlify.site/_mintlify/api/og/v2?division=Connectors\u0026amp;title=Create+a+connector\u0026amp;description=Creates+a+custom+connector+in+the+current+project%27s+registry.+It+is+owned+by+this+project+and+is+not+available+to+the+organization%27s+other+projects.+A+YAML+conn\u0026amp;theme=26a0c4b0d3b33d43a09092cd\u0026amp;signature=1e989894d9c8795fa04adc4f8a4f08b4d3e573e25a36284d262f9952cc4b5b58\">\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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stackone\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#068F56\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"gYj1x4gkdSwpCGVLFVXNVOPQ_wVrePW37ZKJt3HEqys\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/platform/api-reference/v2/connectors/create-a-connector.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.stackone.com/#organization\",\"name\":\"Stackone\",\"url\":\"https://docs.stackone.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-light-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=f08be9c0a142cb1e7fcaa23910c4bf7f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.stackone.com#website\",\"name\":\"Stackone\",\"url\":\"https://docs.stackone.com\",\"publisher\":{\"@id\":\"https://docs.stackone.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector#webpage\",\"url\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector\",\"name\":\"Create a connector\",\"description\":\"Creates a custom connector in the current project's registry. It is owned by this project and is not available to the organization's other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization's plan includes. When every slot is in use the request is refused with 403 custom_connector_slot_limit_reached. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project's latest with 422; both carry that latest version as latest_version.\",\"dateModified\":\"2026-11-13T10:30:56.206Z\",\"isPartOf\":{\"@id\":\"https://docs.stackone.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Connectors\",\"item\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/list-connectors\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a connector\",\"item\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector#apireference\",\"headline\":\"Create a connector\",\"name\":\"Create a connector\",\"description\":\"Creates a custom connector in the current project's registry. It is owned by this project and is not available to the organization's other projects. A YAML connector with a new connector key takes one of the custom connector slots the organization's plan includes. When every slot is in use the request is refused with 403 custom_connector_slot_limit_reached. New versions of an existing connector key and remote MCP connectors take no new slot. A YAML connector whose version already exists is refused with 409, and one whose version is not greater than the project's latest with 422; both carry that latest version as latest_version.\",\"url\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector\",\"mainEntityOfPage\":{\"@id\":\"https://docs.stackone.com/platform/api-reference/v2/connectors/create-a-connector#webpage\"},\"dateModified\":\"2026-11-13T10:30:56.206Z\",\"publisher\":{\"@id\":\"https://docs.stackone.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.stackone.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stackone\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Stackone\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/platform/api-reference/v2/connectors/create-a-connector.md","siteName":"Stackone","nav":{"global":null,"tabs":[{"tab":"Gateway","icon":"rocket","pages":[{"title":"Gateway","href":"/introduction"}]},{"tab":"AI Platforms","icon":"robot","dropdowns":[{"dropdown":"All platforms","icon":"server","description":"Connect any MCP client","groups":[{"group":"Get Started","pages":[{"title":"AI Platforms","sidebarTitle":"Overview","href":"/ai-platforms/overview"},{"title":"StackOne MCP Server","sidebarTitle":"How the MCP Server Works","href":"/ai-platforms/mcp-server"}]}]},{"dropdown":"Anthropic (Claude)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/claude.svg","description":"Claude Chat, Cowork and Claude Code","groups":[{"group":"Anthropic (Claude)","pages":[{"title":"Anthropic (Claude)","sidebarTitle":"Overview","href":"/ai-platforms/anthropic/overview"},{"title":"Claude - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/anthropic/organization-admin-setup"},{"group":"Claude Chat \u0026 Cowork","expanded":true,"pages":[{"title":"Claude Chat \u0026 Cowork - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/anthropic/claude-chat-cowork/organization-user-setup"},{"title":"Claude Chat \u0026 Cowork - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/anthropic/claude-chat-cowork/personal-setup"}]},{"group":"Claude Code","expanded":true,"pages":[{"title":"Claude Code - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/anthropic/claude-code/organization-user-setup"},{"title":"Claude Code - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/anthropic/claude-code/personal-setup"}]}]}]},{"dropdown":"AWS","icon":"aws","description":"Amazon Quick","groups":[{"group":"AWS","pages":[{"title":"AWS","sidebarTitle":"Overview","href":"/ai-platforms/aws/overview"}]},{"group":"Amazon Quick","pages":[{"title":"Amazon Quick - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/aws/amazon-quick/organization-admin-setup"},{"title":"Amazon Quick - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/aws/amazon-quick/organization-user-setup"},{"title":"Amazon Quick - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/aws/amazon-quick/personal-setup"}]}]},{"dropdown":"Cursor","icon":"arrow-pointer","description":"Cursor editor","groups":[{"group":"Cursor","pages":[{"title":"Cursor","sidebarTitle":"Overview","href":"/ai-platforms/cursor/overview"},{"title":"Cursor - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/cursor/organization-user-setup"},{"title":"Cursor - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/cursor/personal-setup"}]}]},{"dropdown":"Dust","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/dust.png","description":"Dust assistants and agents","groups":[{"group":"Dust","pages":[{"title":"Dust","sidebarTitle":"Overview","href":"/ai-platforms/dust/overview"},{"title":"Dust - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/dust/connect-stackone"}]}]},{"dropdown":"Glean","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/glean.png","description":"Glean Agents and Glean Assistant","groups":[{"group":"Glean","pages":[{"title":"Glean","sidebarTitle":"Overview","href":"/ai-platforms/glean/overview"},{"title":"Glean - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/glean/organization-admin-setup"},{"group":"Glean Agents","expanded":true,"pages":[{"title":"Glean Agents - Connect StackOne","sidebarTitle":"Agent Builder Setup","href":"/ai-platforms/glean/glean-agents/agent-builder-setup"}]},{"group":"Glean Assistant","expanded":true,"pages":[{"title":"Glean Assistant - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/glean/glean-assistant/organization-user-setup"}]}]}]},{"dropdown":"Google","icon":"google","description":"Gemini CLI and Gemini Enterprise","groups":[{"group":"Google","pages":[{"title":"Google","sidebarTitle":"Overview","href":"/ai-platforms/google/overview"}]},{"group":"Gemini CLI","pages":[{"title":"Gemini CLI - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/google/gemini-cli/connect-stackone"}]},{"group":"Gemini Enterprise","pages":[{"title":"Gemini Enterprise - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/google/gemini-enterprise/connect-stackone"}]}]},{"dropdown":"Goose","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/goose.png","description":"Goose CLI and Desktop","groups":[{"group":"Goose","pages":[{"title":"Goose","sidebarTitle":"Overview","href":"/ai-platforms/goose/overview"},{"title":"Goose - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/goose/connect-stackone"}]}]},{"dropdown":"LangChain","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/langchain.svg","description":"LangSmith Fleet","groups":[{"group":"LangChain","pages":[{"title":"LangChain","sidebarTitle":"Overview","href":"/ai-platforms/langchain/overview"}]},{"group":"LangSmith Fleet","pages":[{"title":"LangSmith Fleet - Connect StackOne","sidebarTitle":"User Setup","href":"/ai-platforms/langchain/langsmith-fleet/user-setup"}]}]},{"dropdown":"Microsoft","icon":"microsoft","description":"GitHub Copilot and Microsoft 365 Copilot","groups":[{"group":"Microsoft","pages":[{"title":"Microsoft","sidebarTitle":"Overview","href":"/ai-platforms/microsoft/overview"}]},{"group":"GitHub Copilot","pages":[{"title":"GitHub Copilot CLI - Connect StackOne","sidebarTitle":"Copilot CLI User Setup","href":"/ai-platforms/microsoft/github-copilot/copilot-cli"},{"title":"GitHub Copilot in VS Code - Connect StackOne","sidebarTitle":"VS Code User Setup","href":"/ai-platforms/microsoft/github-copilot/vs-code"}]},{"group":"Microsoft 365 Copilot","pages":[{"title":"Microsoft 365 Copilot - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/microsoft/microsoft-365-copilot/connect-stackone"}]}]},{"dropdown":"n8n","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/n8n.png","description":"n8n workflows","groups":[{"group":"n8n","pages":[{"title":"n8n","sidebarTitle":"Overview","href":"/ai-platforms/n8n/overview"},{"title":"n8n - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/n8n/connect-stackone"}]}]},{"dropdown":"OpenAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/agents/openai-logo.svg","description":"ChatGPT and Codex","groups":[{"group":"OpenAI","pages":[{"title":"OpenAI","sidebarTitle":"Overview","href":"/ai-platforms/openai/overview"}]},{"group":"ChatGPT","pages":[{"title":"ChatGPT - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/openai/chatgpt/organization-admin-setup"},{"title":"ChatGPT - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/openai/chatgpt/organization-user-setup"},{"title":"ChatGPT - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/openai/chatgpt/personal-setup"}]},{"group":"Codex","pages":[{"title":"Codex - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/openai/codex/connect-stackone"}]}]}]},{"tab":"Connectors","icon":"plug","pages":[{"title":"Connectors","href":"/connectors/introduction"}]},{"tab":"Embed","icon":"cube","pages":[{"title":"Embed","href":"/embed/overview"}]},{"tab":"Platform API","icon":"code","groups":[{"group":"Overview","root":{"title":"Platform API Reference","href":"/platform-api/overview"},"expanded":true,"pages":[{"title":"Authentication","sidebarTitle":"Authentication","href":"/platform-api/authentication"},{"group":"Request Parameters","pages":[{"title":"Pagination","href":"/platform-api/request-parameters/pagination"},{"title":"Filtering","href":"/platform-api/request-parameters/filtering"},{"title":"Expanding Fields","href":"/platform-api/request-parameters/expanding-fields"}]},{"title":"Rate Limiting","href":"/platform-api/rate-limiting"},{"title":"Platform Events","sidebarTitle":"Platform Events","href":"/platform-api/platform-events"},{"title":"API SDKs","href":"/platform-api/api-sdks"}]},{"group":"Accounts","icon":"users","expanded":true,"pages":[{"openapi":"get /v2/accounts","title":"List accounts","href":"/platform/api-reference/v2/accounts/list-accounts"},{"openapi":"get /v2/accounts/filters","title":"List account filter values","href":"/platform/api-reference/v2/accounts/list-account-filter-values"},{"openapi":"get /v2/accounts/{id}","title":"Get an account","href":"/platform/api-reference/v2/accounts/get-an-account"},{"openapi":"patch /v2/accounts/{id}","title":"Patch an account","href":"/platform/api-reference/v2/accounts/patch-an-account"},{"openapi":"delete /v2/accounts/{id}","title":"Delete an account","href":"/platform/api-reference/v2/accounts/delete-an-account"}]},{"group":"Actions","icon":"bolt","expanded":true,"pages":[{"openapi":"post /actions/search","title":"Search connector actions by semantic similarity","href":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity"},{"openapi":"post /actions/rpc","title":"Make an RPC call to an action","href":"/platform/api-reference/actions/make-an-rpc-call-to-an-action"},{"openapi":"post /actions/rpc/synced","title":"Read synced action data from the datasync index","href":"/platform/api-reference/actions/read-synced-action-data-from-the-datasync-index"},{"openapi":"post /actions/rpc/synced/queryable_fields","title":"List the fields a synced action's data can be queried by","href":"/platform/api-reference/actions/list-the-fields-a-synced-actions-data-can-be-queried-by"},{"openapi":"post /unified/check_permissions","title":"Check user permissions on a resource","href":"/platform/api-reference/actions/check-user-permissions-on-a-resource"}]},{"group":"Connect Sessions","icon":"link","expanded":true,"pages":[{"openapi":"post /connect_sessions","title":"Create Connect Session","href":"/platform/api-reference/connect-sessions/create-connect-session"},{"openapi":"get /connect_sessions/{id}","title":"Get Connect Session","href":"/platform/api-reference/connect-sessions/get-connect-session"},{"openapi":"post /connect_sessions/authenticate","title":"Authenticate Connect Session","href":"/platform/api-reference/connect-sessions/authenticate-connect-session"}]},{"group":"Connector Profiles","icon":"sliders","expanded":true,"pages":[{"openapi":"get /v2/connector_profiles","title":"List connector profiles","href":"/platform/api-reference/v2/connector-profiles/list-connector-profiles"},{"openapi":"get /v2/connector_profiles/{id}","title":"Get a connector profile","href":"/platform/api-reference/v2/connector-profiles/get-a-connector-profile"},{"openapi":"post /v2/connector_profiles","title":"Create a connector profile","href":"/platform/api-reference/v2/connector-profiles/create-a-connector-profile"},{"openapi":"patch /v2/connector_profiles/{id}","title":"Patch a connector profile","href":"/platform/api-reference/v2/connector-profiles/patch-a-connector-profile"},{"openapi":"delete /v2/connector_profiles/{id}","title":"Delete a connector profile","href":"/platform/api-reference/v2/connector-profiles/delete-a-connector-profile"}]},{"group":"Connectors","icon":"puzzle-piece","expanded":true,"pages":[{"openapi":"get /v2/connectors","title":"List connectors","href":"/platform/api-reference/v2/connectors/list-connectors"},{"openapi":"get /v2/connectors/{id}","title":"Get connector","href":"/platform/api-reference/v2/connectors/get-connector"},{"openapi":"get /v2/connectors/{id}/source","title":"Get connector source","href":"/platform/api-reference/v2/connectors/get-connector-source"},{"openapi":"get /v2/connectors/{id}/actions/{actionId}","title":"Get connector action","href":"/platform/api-reference/v2/connectors/get-connector-action"},{"openapi":"get /v2/connectors/{id}/event_actions/{eventId}","title":"Get connector event action","href":"/platform/api-reference/v2/connectors/get-connector-event-action"},{"openapi":"get /v2/connectors/{id}/versions","title":"List connector versions","description":"Returns the registry versions of the connector available to the project, newest first — the version options a connector profile can be pinned to. Returns an empty array for connectors that exist but have no registry versions.","href":"/platform/api-reference/v2/connectors/list-connector-versions"},{"openapi":"post /v2/connectors","title":"Create a connector","href":"/platform/api-reference/v2/connectors/create-a-connector"},{"openapi":"post /v2/connectors/{id}/action_refreshes","title":"Create a connector action refresh","description":"Creates an action refresh for one of the project's own remote MCP connectors: lists the tools the connector's server offers today, through every active linked account the caller may run actions with, and merges them into the latest version of the connector: tools the server added become actions, actions whose tool changed are rewritten, and actions whose tool the server no longer offers are removed. An account is only ever asked through the server it was linked to, so one whose connector version names another server is skipped. Removals are skipped when any account was skipped or could not reach the server. A connector that had no actions yet keeps its version; any other change is registered as a new version, which becomes the latest. Answers 403 when the caller has no such account, and 502 when no account could reach the server.","href":"/platform/api-reference/v2/connectors/create-a-connector-action-refresh"},{"openapi":"delete /v2/connectors/{id}","title":"Delete a connector","href":"/platform/api-reference/v2/connectors/delete-a-connector"}]},{"group":"Data Sync","icon":"rotate","expanded":true,"pages":[{"group":"Sync Configs","expanded":true,"pages":[{"openapi":"get /v2/data_sync/sync_configs","title":"List sync configs","href":"/platform/api-reference/v2/data-sync/list-sync-configs"},{"openapi":"get /v2/data_sync/sync_configs/{id}","title":"Get a sync config","href":"/platform/api-reference/v2/data-sync/get-a-sync-config"},{"openapi":"get /v2/data_sync/sync_configs/{id}/parameters","title":"Get a sync config action's parameters","href":"/platform/api-reference/v2/data-sync/get-a-sync-config-actions-parameters"},{"openapi":"post /v2/data_sync/sync_configs","title":"Create a sync config","href":"/platform/api-reference/v2/data-sync/create-a-sync-config"},{"openapi":"patch /v2/data_sync/sync_configs/{id}","title":"Patch a sync config","href":"/platform/api-reference/v2/data-sync/patch-a-sync-config"},{"openapi":"delete /v2/data_sync/sync_configs/{id}","title":"Delete a sync config","href":"/platform/api-reference/v2/data-sync/delete-a-sync-config"}]},{"group":"Schedules","expanded":true,"pages":[{"openapi":"get /v2/data_sync/schedules","title":"List schedules","href":"/platform/api-reference/v2/data-sync/list-schedules"},{"openapi":"get /v2/data_sync/schedules/{id}","title":"Get a schedule","href":"/platform/api-reference/v2/data-sync/get-a-schedule"},{"openapi":"patch /v2/data_sync/schedules/{id}","title":"Patch a schedule","href":"/platform/api-reference/v2/data-sync/patch-a-schedule"}]},{"group":"Runs","expanded":true,"pages":[{"openapi":"get /v2/data_sync/runs","title":"List runs","href":"/platform/api-reference/v2/data-sync/list-runs"},{"openapi":"get /v2/data_sync/runs/{id}","title":"Get a run","href":"/platform/api-reference/v2/data-sync/get-a-run"}]}]},{"group":"Logs","icon":"file-lines","expanded":true,"pages":[{"openapi":"post /logs","title":"List Logs","href":"/platform/api-reference/logs/list-logs"},{"openapi":"post /logs/platform","title":"List Platform Logs","href":"/platform/api-reference/logs/list-platform-logs"},{"openapi":"post /logs/provider","title":"List Provider Logs","href":"/platform/api-reference/logs/list-provider-logs"},{"group":"Action Logs","expanded":true,"pages":[{"openapi":"post /logs/actions","title":"List Action Logs","href":"/platform/api-reference/logs/list-action-logs"},{"openapi":"get /logs/actions/{actionRunId}","title":"Get Action Log","href":"/platform/api-reference/logs/get-action-log"},{"openapi":"get /logs/actions/{actionRunId}/advanced","title":"Get Action Advanced Log","href":"/platform/api-reference/logs/get-action-advanced-log"},{"openapi":"get /logs/actions/{actionRunId}/defender","title":"Get Action Defender Log","href":"/platform/api-reference/logs/get-action-defender-log"}]},{"group":"Step Logs","expanded":true,"pages":[{"openapi":"post /logs/steps","title":"List Step Logs","href":"/platform/api-reference/logs/list-step-logs"},{"openapi":"get /logs/actions/{actionRunId}/steps","title":"List Action Step Logs","href":"/platform/api-reference/logs/list-action-step-logs"},{"openapi":"get /logs/actions/{actionRunId}/steps/{stepIndex}","title":"Get Step Log","href":"/platform/api-reference/logs/get-step-log"},{"openapi":"get /logs/actions/{actionRunId}/steps/{stepIndex}/advanced","title":"Get Step Advanced Log","href":"/platform/api-reference/logs/get-step-advanced-log"}]},{"group":"Stats","expanded":true,"pages":[{"openapi":"post /logs/stats/aggregate","title":"Get Logs Stats Aggregate","href":"/platform/api-reference/logs/get-logs-stats-aggregate"},{"openapi":"post /logs/stats/dimensions","title":"Get Logs Stats Dimensions","href":"/platform/api-reference/logs/get-logs-stats-dimensions"}]}]},{"group":"MCP","icon":"plug","expanded":true,"pages":[{"openapi":"post /mcp","title":"Send MCP JSON-RPC message","href":"/platform/api-reference/mcp/send-mcp-json-rpc-message"}]},{"group":"Webhooks","icon":"webhook","expanded":true,"pages":[{"openapi":"get /v2/webhooks","title":"List webhooks","href":"/platform/api-reference/v2/webhooks/list-webhooks"},{"openapi":"get /v2/webhooks/{id}","title":"Get a webhook","href":"/platform/api-reference/v2/webhooks/get-a-webhook"},{"openapi":"post /v2/webhooks","title":"Create a webhook","href":"/platform/api-reference/v2/webhooks/create-a-webhook"},{"openapi":"patch /v2/webhooks/{id}","title":"Update a webhook","href":"/platform/api-reference/v2/webhooks/update-a-webhook"},{"openapi":"delete /v2/webhooks/{id}","title":"Delete a webhook","href":"/platform/api-reference/v2/webhooks/delete-a-webhook"},{"openapi":"post /v2/webhooks/events","title":"Send webhook events","href":"/platform/api-reference/v2/webhooks/send-webhook-events"}]}]}]},"basePath":"","title":"Create a connector - Stackone","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}