Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.
Configurations control how Leaf pulls data from providers, processes machine files, creates field operations, and generates output formats. You can set configurations at the API owner level (applies to all Leaf users by default) or at the individual Leaf user level for granular control.
Every API owner starts with a default set of configurations. These defaults can be changed but not deleted or set to null.When you set a configuration on a specific Leaf user, that user stops inheriting that configuration from the API owner. The Leaf user’s value takes precedence and does not change if you later update the API owner’s configuration.If a Leaf user has no custom configuration, they inherit everything from the API owner.
Configuration changes are not retroactive. Existing data is not reprocessed when you change a configuration. Use the Reprocess Operation endpoint if you need to apply new settings to existing data.
Field Operations for how merge ranges and split settings shape operations.
Last modified on September 29, 2026
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Leaf Documentation","colors":{"primary":"#00886b","light":"#07C983","dark":"#00886b"},"logo":{"light":"https://mintcdn.com/leaf-3ed5893a/to88HRn_L8ezHDrX/logo/light.png?fit=max\u0026auto=format\u0026n=to88HRn_L8ezHDrX\u0026q=85\u0026s=8ce24e422c9bf087336b65351eb51f4c","dark":"https://mintcdn.com/leaf-3ed5893a/to88HRn_L8ezHDrX/logo/dark.png?fit=max\u0026auto=format\u0026n=to88HRn_L8ezHDrX\u0026q=85\u0026s=7c5b24b746c2c02501ac6fea486c3a51","href":"https://withleaf.io/"},"favicon":"https://mintcdn.com/leaf-3ed5893a/to88HRn_L8ezHDrX/favicon.png?fit=max\u0026auto=format\u0026n=to88HRn_L8ezHDrX\u0026q=85\u0026s=a435f8f25c1ed914dc32b03c92d844cd","appearance":{"default":"light"},"background":{"color":{"light":"#ffffff","dark":"#18191a"}},"navbar":{"links":[{"icon":"github","href":"https://status.withleaf.io","label":"API Status"},{"href":"https://dashboard.withleaf.io","label":"Log In"}],"primary":{"type":"button","label":"Request Demo","href":"https://withleaf.io/account/get-a-demo"}},"footer":{"socials":{"instagram":"https://www.instagram.com/withleaf_","linkedin":"https://www.linkedin.com/company/leaf-agriculture","x":"https://twitter.com/LeafAgriculture","youtube":"https://www.youtube.com/@leafagriculture7933"}},"seo":{"metatags":{"robots":"noindex"},"indexing":"navigable"},"fonts":{"heading":{"family":"Satoshi","source":"https://cdn.fontshare.com/wf/P2LQKHE6KA6ZP4AAGN72KDWMHH6ZH3TA/ZC32TK2P7FPS5GFTL46EU6KQJA24ZYDB/7AHDUZ4A7LFLVFUIFSARGIWCRQJHISQP.woff2","format":"woff2"},"body":{"family":"Inter"}},"integrations":{"mixpanel":{"projectToken":"2aa8982706dc53402184ef7b6e555d32"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"About Us","icon":"circle-user","href":"https://withleaf.io/company"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"leaf-3ed5893a","hasAudioNarration":false,"actualSubdomain":"leaf-3ed5893a","customDomains":["docs.withleaf.io"],"gitSource":{"type":"github","owner":"leaf-agriculture","repo":"docs-v2","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeca9998029e5fb8e3f08df","collectionId":"15f56d4b-47f7-4765-8f1e-2cfd26e8e289","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeca9998029e5fb8e3f08df"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeca9998029e5fb8e3f08df","clientVersion":"0.0.4071","searchFilterCounts":[{"language":"default","tag":"Documentation","count":59},{"language":"default","tag":"API Reference","count":25},{"language":"default","tag":"Guides","count":23},{"language":"default","tag":"Tutorials","count":18},{"language":"default","tag":"Connecting Providers","count":17},{"language":"default","tag":"Beta","count":10},{"language":"default","tag":"OEM and Provider Integrations","count":10},{"language":"default","tag":"Data Hierarchy","count":9},{"language":"default","tag":"Machine Data","count":6},{"language":"default","tag":"Resources","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"help@withleaf.io","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/globals.css","content":".get,.post,.put,.patch,.delete{display:inline-block;padding:2px 8px;border-radius:4px;font-size:12px;font-weight:600;text-transform:uppercase;font-family:monospace}.get{background-color:#00866d;color:white}.post{background-color:#edc043;color:white}.patch{background-color:#edc043;color:white}.delete{background-color:#f25925;color:white}.put{background-color:#edc043;color:white}"}],"page":{"pagePath":"configuration/overview","slug":"/configuration/overview","pageMetadata":{"title":"Configurations","sidebarTitle":"Overview","description":"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.","href":"/configuration/overview"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Configurations control how Leaf pulls data from providers, processes machine files, creates field operations, and generates output formats. You can set configurations at the API owner level (applies to all Leaf users by default) or at the individual Leaf user level for granular control.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-configuration-inheritance-works`,children:`How configuration inheritance works`}),`\n`,_jsx(_components.p,{children:`Every API owner starts with a default set of configurations. These defaults can be changed but not deleted or set to null.`}),`\n`,_jsx(_components.p,{children:`When you set a configuration on a specific Leaf user, that user stops inheriting that configuration from the API owner. The Leaf user’s value takes precedence and does not change if you later update the API owner’s configuration.`}),`\n`,_jsx(_components.p,{children:`If a Leaf user has no custom configuration, they inherit everything from the API owner.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Configuration changes are not retroactive. Existing data is not reprocessed when you change a configuration. Use the Reprocess Operation endpoint if you need to apply new settings to existing data.`})}),`\n`,_jsx(Heading,{level:`2`,id:`endpoints`,children:`Endpoints`}),`\n`,_jsxs(_components.p,{children:[`Base URL: `,_jsx(_components.code,{children:`https://api.withleaf.io/services/config/api`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Path`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Get API owner configuration`}),_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/configs`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Get Leaf user configuration`}),_jsx(_components.td,{children:`GET`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/configs/{leafUserId}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create Leaf user configuration`}),_jsx(_components.td,{children:`POST`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/configs/{leafUserId}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Update API owner configuration`}),_jsx(_components.td,{children:`PATCH`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/configs`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Update Leaf user configuration`}),_jsx(_components.td,{children:`PATCH`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/configs/{leafUserId}`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Delete Leaf user configuration`}),_jsx(_components.td,{children:`DELETE`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`/configs/{leafUserId}`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`configuration-categories`,children:`Configuration categories`}),`\n`,_jsxs(_components.p,{children:[`Configurations are grouped by what they control. See the `,_jsx(_components.a,{href:`/configuration/reference`,children:`Configuration Reference`}),` for the full list with defaults and descriptions.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Category`}),_jsx(_components.th,{children:`What it controls`}),_jsx(_components.th,{children:`Key configs`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Data synchronization`}),_jsx(_components.td,{children:`Which data Leaf pulls from providers`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`fieldsAutoSync`}),`, `,_jsx(_components.code,{children:`operationsAutoSync`}),`, `,_jsx(_components.code,{children:`customDataSync`}),`, `,_jsx(_components.code,{children:`organizationDataSync`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Field boundary management`}),_jsx(_components.td,{children:`How boundaries are validated, linked, and merged`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`automaticFixBoundary`}),`, `,_jsx(_components.code,{children:`fieldsAttachIntersection`}),`, `,_jsx(_components.code,{children:`fieldsAutoMerge`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Machine file conversion`}),_jsx(_components.td,{children:`How raw data is cleaned and output`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`cleanupStandardGeojson`}),`, `,_jsx(_components.code,{children:`cleanupRules`}),`, `,_jsx(_components.code,{children:`unitMeasurement`}),`, `,_jsx(_components.code,{children:`enableGeoparquetOutput`}),`, `,_jsx(_components.code,{children:`cropOptional`}),`, `,_jsx(_components.code,{children:`seedRateOptional`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Field operations`}),_jsx(_components.td,{children:`How files merge into operations`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`fieldOperationCreation`}),`, `,_jsx(_components.code,{children:`operationsFilteredGeojson`}),`, `,_jsx(_components.code,{children:`operationsRemoveOutliers`}),`, `,_jsx(_components.code,{children:`operationsMergeRange`}),`, `,_jsx(_components.code,{children:`splitOperationsByField`}),`, `,_jsx(_components.code,{children:`outOfStandardOperations`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Image generation`}),_jsx(_components.td,{children:`Which images are produced for operations`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`operationsImageCreation`}),`, `,_jsx(_components.code,{children:`operationsImageAsGeoTiff`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Irrigation`}),_jsx(_components.td,{children:`How far back to fetch irrigation data`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`irrigationProcessingRange`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Satellite imagery`}),_jsx(_components.td,{children:`Higher-fidelity v2 image renderings`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`satelliteImagesV2`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`configurations-by-use-case`,children:`Configurations by use case`}),`\n`,_jsx(_components.p,{children:`The right configuration depends on your use case. Here are recommended starting points.`}),`\n`,_jsx(Heading,{level:`3`,id:`crop-insurance`,children:`Crop insurance`}),`\n`,_jsx(_components.p,{children:`Focus on consistent results close to SMS-driven pipelines. Key settings:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cleanupStandardGeojson`}),`: `,_jsx(_components.code,{children:`true`}),` with default rules.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`operationsRemoveOutliers`}),`: `,_jsx(_components.code,{children:`true`}),` with `,_jsx(_components.code,{children:`operationsOutliersLimit`}),` at `,_jsx(_components.code,{children:`3`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`splitOperationsByField`}),`: `,_jsx(_components.code,{children:`true`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`operationsImageCreation`}),`: `,_jsx(_components.code,{children:`true`}),` for visual verification.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`unitMeasurement`}),`: `,_jsx(_components.code,{children:`IMPERIAL`}),` (for US customers).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`fmis`,children:`FMIS`}),`\n`,_jsx(_components.p,{children:`Prioritize processing efficiency and pull only the data you need:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`customDataSync`}),`: `,_jsx(_components.code,{children:`true`}),` to selectively process fields.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`fieldsAutoSync`}),`: `,_jsx(_components.code,{children:`true`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`operationsAutoSync`}),`: `,_jsx(_components.code,{children:`true`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`enableGeoparquetOutput`}),`: `,_jsx(_components.code,{children:`true`}),` for faster data ingestion.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`managed-service-provider`,children:`Managed service provider`}),`\n`,_jsx(_components.p,{children:`Similar to FMIS, with additional attention to multi-organization accounts:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`organizationDataSync`}),`: `,_jsx(_components.code,{children:`SELECTED_ONLY`}),` to limit scope.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`customDataSync`}),`: `,_jsx(_components.code,{children:`true`}),`.`]}),`\n`,_jsx(_components.li,{children:`Per-Leaf-user configurations for different growers with different processing needs.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-to-do-next`,children:`What to do next`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/configuration/reference`,children:`Configuration Reference`}),` for every config option with defaults and descriptions.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/configurations`,children:`Configuration API Reference`}),` for endpoint details.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/machine-data/overview`,children:`Machine Data Overview`}),` for how configurations affect file processing.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/machine-data/field-operations`,children:`Field Operations`}),` for how merge ranges and split settings shape operations.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Configurations","sidebarTitle":"Overview","description":"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.","href":"/configuration/overview"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"How configuration inheritance works","slug":"how-configuration-inheritance-works","depth":2,"children":[]},{"title":"Endpoints","slug":"endpoints","depth":2,"children":[]},{"title":"Configuration categories","slug":"configuration-categories","depth":2,"children":[]},{"title":"Configurations by use case","slug":"configurations-by-use-case","depth":2,"children":[{"title":"Crop insurance","slug":"crop-insurance","depth":3,"children":[]},{"title":"FMIS","slug":"fmis","depth":3,"children":[]},{"title":"Managed service provider","slug":"managed-service-provider","depth":3,"children":[]}]},{"title":"What to do next","slug":"what-to-do-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"leaf-3ed5893a","siteName":"Leaf Documentation","title":"Configurations - Leaf Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T12:45:10.575Z","gitLastModified":"2026-09-29T12:44:52.000Z","originalFileLocation":"configuration/overview.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=\"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Leaf Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configurations - Leaf Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Leaf Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.withleaf.io/configuration/overview\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://leaf-3ed5893a.mintlify.app/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Configurations\u0026amp;description=Control+how+Leaf+syncs%2C+processes%2C+and+outputs+field+boundaries%2C+machine+files%2C+operations%2C+images%2C+and+irrigation+at+the+API+owner+and+Leaf+user+level.\u0026amp;theme=df28ea0c62b563cc8e5aedca\u0026amp;signature=2f03c8cdc0b9e355afce12302a349ee7848d97dadd4d4ea31ca14264e71ec309\">\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=\"Configurations - Leaf Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://leaf-3ed5893a.mintlify.app/_mintlify/api/og/v2?division=Configuration\u0026amp;title=Configurations\u0026amp;description=Control+how+Leaf+syncs%2C+processes%2C+and+outputs+field+boundaries%2C+machine+files%2C+operations%2C+images%2C+and+irrigation+at+the+API+owner+and+Leaf+user+level.\u0026amp;theme=df28ea0c62b563cc8e5aedca\u0026amp;signature=2f03c8cdc0b9e355afce12302a349ee7848d97dadd4d4ea31ca14264e71ec309\">\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/leaf-3ed5893a/IA--hOPjRaQAEcyW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Leaf Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00886b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.withleaf.io/configuration/overview\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/configuration/overview.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.withleaf.io/#organization\",\"name\":\"Leaf Documentation\",\"url\":\"https://docs.withleaf.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/leaf-3ed5893a/to88HRn_L8ezHDrX/logo/light.png?fit=max\u0026auto=format\u0026n=to88HRn_L8ezHDrX\u0026q=85\u0026s=8ce24e422c9bf087336b65351eb51f4c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.withleaf.io#website\",\"name\":\"Leaf Documentation\",\"url\":\"https://docs.withleaf.io\",\"publisher\":{\"@id\":\"https://docs.withleaf.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.withleaf.io/configuration/overview#webpage\",\"url\":\"https://docs.withleaf.io/configuration/overview\",\"name\":\"Configurations\",\"description\":\"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.\",\"dateModified\":\"2026-09-29T12:44:52.000Z\",\"isPartOf\":{\"@id\":\"https://docs.withleaf.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.withleaf.io/configuration/overview#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.withleaf.io/configuration/overview#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Leaf Documentation\",\"item\":\"https://docs.withleaf.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configurations\",\"item\":\"https://docs.withleaf.io/configuration/overview\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.withleaf.io/configuration/overview#article\",\"headline\":\"Configurations\",\"name\":\"Configurations\",\"description\":\"Control how Leaf syncs, processes, and outputs field boundaries, machine files, operations, images, and irrigation at the API owner and Leaf user level.\",\"url\":\"https://docs.withleaf.io/configuration/overview\",\"mainEntityOfPage\":{\"@id\":\"https://docs.withleaf.io/configuration/overview#webpage\"},\"dateModified\":\"2026-09-29T12:44:52.000Z\",\"publisher\":{\"@id\":\"https://docs.withleaf.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.withleaf.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Leaf Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Leaf Documentation","nav":{"global":{"anchors":[{"anchor":"About Us","icon":"circle-user","href":"https://withleaf.io/company"}]},"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":""}]},{"tab":"Documentation","icon":"book-open","pages":[{"group":"Getting Started","pages":[{"title":"Welcome to Leaf","sidebarTitle":"Welcome","href":"/getting-started/welcome"},{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/getting-started/quickstart"},{"title":"Core Concepts","sidebarTitle":"Core Concepts","href":"/getting-started/core-concepts"},{"title":"Authentication","sidebarTitle":"Authentication","description":"OAuth2 with refresh tokens, and `/authenticate`. Get a token, send it as a Bearer header, and see example requests in cURL, Python, and JavaScript.","href":"/getting-started/authentication"}]},{"group":"Configuration","pages":[{"title":"Configurations","sidebarTitle":"Overview","href":"/configuration/overview"},{"title":"Configuration Reference","sidebarTitle":"Reference","description":"Reference for every Leaf configuration option with defaults, allowed values, and behavior for data sync, boundaries, file conversion, operations, and images.","href":"/configuration/reference"}]},{"group":"Alerts","pages":[{"title":"Alerts Overview","sidebarTitle":"Overview","href":"/alerts/overview"},{"title":"Alert Events","sidebarTitle":"Events","href":"/alerts/events"},{"title":"Alert Authentication","sidebarTitle":"Authentication","href":"/alerts/authentication"}]},{"group":"Leaf Users","pages":[{"title":"Leaf Users","sidebarTitle":"Overview","href":"/leaf-users/overview"}]},{"group":"Connecting Providers","pages":[{"title":"Provider Authentication","sidebarTitle":"Overview","href":"/providers/overview"},{"title":"John Deere","sidebarTitle":"John Deere","href":"/providers/john-deere"},{"title":"Climate FieldView","sidebarTitle":"Climate FieldView","href":"/providers/climate-fieldview"},{"title":"CLAAS","sidebarTitle":"CLAAS","href":"/providers/claas"},{"title":"CNHi (AFS Connect)","sidebarTitle":"CNHI (AFS Connect - Legacy)","href":"/providers/cnhi"},{"title":"CNHI FieldOps","sidebarTitle":"CNHI FieldOps","href":"/providers/cnhi-fieldops"},{"title":"Trimble","sidebarTitle":"Trimble","href":"/providers/trimble"},{"title":"FarmEngage","sidebarTitle":"FarmEngage","href":"/providers/farmengage"},{"title":"AgLeader","sidebarTitle":"AgLeader","href":"/providers/agleader"},{"title":"Raven","sidebarTitle":"Raven","href":"/providers/raven"},{"title":"Raven Slingshot","sidebarTitle":"Raven Slingshot","href":"/providers/raven-slingshot"},{"title":"Stara","sidebarTitle":"Stara","href":"/providers/stara"},{"title":"Sentera","sidebarTitle":"Sentera","href":"/providers/sentera"},{"title":"Agvance","sidebarTitle":"Agvance","href":"/providers/agvance"},{"title":"Precision Planting Panorama","sidebarTitle":"Panorama","href":"/providers/panorama"},{"title":"Lindsay","sidebarTitle":"Lindsay","href":"/providers/lindsay"},{"title":"Valley","sidebarTitle":"Valley","href":"/providers/valley"}]},{"group":"Data Hierarchy","pages":[{"title":"Fields Overview","sidebarTitle":"Overview","href":"/fields/overview"},{"title":"Provider Organizations","sidebarTitle":"Organizations","href":"/providers/organizations"},{"title":"Growers","sidebarTitle":"Growers","href":"/fields/growers"},{"title":"Managing Fields","sidebarTitle":"Fields","href":"/fields/managing-fields"},{"title":"Uploading Boundaries","sidebarTitle":"Boundaries","href":"/fields/uploading-boundaries"}]},{"group":"Machine Data","pages":[{"title":"Machine Data Overview","sidebarTitle":"Overview","href":"/machine-data/overview"},{"title":"Uploading Files","sidebarTitle":"Uploading Files","href":"/machine-data/uploading-files"},{"title":"File Conversion","sidebarTitle":"File Conversion","href":"/machine-data/file-conversion"},{"title":"Field Operations","sidebarTitle":"Field Operations","href":"/machine-data/field-operations"},{"title":"Sample Output","sidebarTitle":"Sample Output","href":"/machine-data/sample-output"},{"title":"Units","sidebarTitle":"Units","href":"/machine-data/units"}]},{"group":"Satellite Imagery","pages":[{"title":"Satellite Imagery Overview","sidebarTitle":"Overview","href":"/satellite/overview"},{"title":"Sentinel-2","sidebarTitle":"Sentinel-2","href":"/satellite/sentinel"},{"title":"PlanetScope","sidebarTitle":"PlanetScope","href":"/satellite/planet"},{"title":"Satellite Images v2","sidebarTitle":"Images v2","href":"/satellite/images-v2"}]},{"group":"Weather","pages":[{"title":"Weather Overview","sidebarTitle":"Overview","href":"/weather/overview"}]},{"group":"Soil Sampling","pages":[{"title":"Soil Sampling Overview","sidebarTitle":"Overview","href":"/soil/overview"},{"title":"Supported Soil Formats","sidebarTitle":"Supported Formats","href":"/soil/supported-formats"}]},{"group":"Leaf Lake","pages":[{"title":"Leaf Lake Overview","sidebarTitle":"Overview","href":"/leaf-lake/overview"},{"title":"Querying Leaf Lake","sidebarTitle":"Schema \u0026 Queries","href":"/leaf-lake/querying"}]},{"group":"UI Components","pages":[{"title":"Leaf Link","sidebarTitle":"Leaf Link","href":"/components/leaf-link"},{"title":"Magic Link","sidebarTitle":"Magic Link","href":"/components/magic-link"}]},{"group":"MCP Server","pages":[{"title":"MCP Server","sidebarTitle":"Overview","href":"/mcp/overview"},{"title":"MCP Tools Reference","sidebarTitle":"Tools Reference","href":"/mcp/tools-reference"}]},{"group":"Irrigation","pages":[{"title":"Irrigation Overview","sidebarTitle":"Overview","href":"/irrigation/overview"}]},{"group":"Beta","pages":[{"title":"Beta Features","sidebarTitle":"Overview","href":"/beta/overview"},{"title":"Assets","sidebarTitle":"Assets","href":"/beta/assets"},{"title":"Prescriptions","sidebarTitle":"Prescriptions","href":"/beta/prescriptions"},{"title":"Layers","sidebarTitle":"Layers","href":"/beta/layers"},{"title":"Input Validator","sidebarTitle":"Input Validator","href":"/beta/input-validator"},{"title":"Operations Planning","sidebarTitle":"Operations Planning","href":"/beta/operations-planning"}]},{"group":"Administration","pages":[{"title":"Usage Tracking","sidebarTitle":"Usage Tracking","href":"/billing/overview"}]},{"group":"Sharing Data","hidden":true,"pages":[{"title":"Leaf Connect","sidebarTitle":"Leaf Connect","href":"/components/leaf-connect"}]}]},{"tab":"Guides","icon":"lightbulb","pages":[{"title":"Guides","href":"/guides/by-use-case/managed-service-provider"}]},{"tab":"API Reference","icon":"code-simple","pages":[{"title":"API Reference","href":"/api-reference/authentication"}]},{"tab":"Resources","icon":"books","pages":[{"title":"Resources","href":"/resources/glossary"}]}]},"basePath":"","title":"Configurations - Leaf Documentation","buildId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","deploymentId":"dpl_GZsjphRpnhWkstV12jxWNcMHFyox","dynamics":[],"chunks":[]}
