Scope:projects:write. Partial update. All fields optional, must provide at least one.
Request body
Same fields as create. Pass null to clear nullable fields, omit to leave untouched.
Response 200
Returns the updated unit.
Webhook side effects
Always: unit.updated.
If status changed: unit.status_changed. The payload includes both the unit and its parent project, so receivers don’t need a second API call to know what was sold.
The unit.status_changed event is the canonical signal for “a unit just became available / reserved / sold”. Use it to update your website inventory, send Slack notifications, or trigger commission flows.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"FlowEstate Developers","description":"Build integrations on top of FlowEstate. REST API for leads, personal member access, projects, units, and outbound webhooks.","colors":{"primary":"#3066B6","light":"#5D8FD0","dark":"#1F4373"},"logo":{"light":"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/logo/light.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=5c2fb629132bfb174396224c285666dc","dark":"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/logo/dark.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=d19d5534db3207dd3b86ff78f71974d5","href":"https://developers.flowestate.app"},"favicon":"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/favicon.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=21a743943c7ba01b5f69c4040d3184d1","navbar":{"links":[{"href":"https://panel.flowestate.app","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://panel.flowestate.app/dashboard/settings/api-keys"}},"footer":{"socials":{"x":"https://x.com/flowestate","linkedin":"https://www.linkedin.com/company/flowestate"}},"search":{"prompt":"Search FlowEstate API docs..."},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.flowestate.app"},{"anchor":"Support","icon":"envelope","href":"mailto:soporte@flowestate.app"}]},"languages":[{"language":"en","href":"introduction"},{"language":"es","href":"es/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"flowestate","hasAudioNarration":false,"actualSubdomain":"flowestate","customDomains":["developers.flowestate.app"],"gitSource":{"type":"github","owner":"flow-estate","repo":"flowestate-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa64ad4882bb710a9b8f0b4","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"en","tag":"API Reference","count":13},{"language":"es","tag":"Referencia API","count":13},{"language":"en","tag":"Documentation","count":12},{"language":"es","tag":"Documentación","count":12},{"language":"en","tag":"Core concepts","count":7},{"language":"es","tag":"Conceptos centrales","count":7},{"language":"en","tag":"Automation","count":4},{"language":"es","tag":"Automatización","count":4},{"language":"en","tag":"Leads","count":3},{"language":"es","tag":"Leads","count":3},{"language":"en","tag":"Overview","count":2},{"language":"en","tag":"Catalog","count":2},{"language":"en","tag":"Webhooks","count":2},{"language":"en","tag":"Reference","count":2},{"language":"en","tag":"Get Started","count":2},{"language":"es","tag":"Generales","count":2},{"language":"es","tag":"Catálogo","count":2},{"language":"es","tag":"Webhooks","count":2},{"language":"es","tag":"Referencia","count":2},{"language":"es","tag":"Empezar","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/units","slug":"/api-reference/units","pageMetadata":{"title":"Units","description":"Individual units within a project. Track availability with status: available / reserved / sold.","href":"/api-reference/units"},"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: \"Individual units within a project. Track availability with status: available / reserved / sold.\"\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={code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Units always belong to a project. All endpoints are scoped under `,_jsx(_components.code,{children:`/projects/{projectId}/units`}),`.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`list-units`,children:`List units`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`GET`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /projects/{projectId}/units`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scope:`}),` `,_jsx(_components.code,{children:`projects:read`}),`. Returns all units of the project. Returns `,_jsx(_components.code,{children:`404 NOT_FOUND`}),` if the project doesn’t exist or belongs to another organization.`]}),`\n`,_jsx(Heading,{level:`3`,id:`response-200`,children:`Response 200`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"unit_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"projectId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"proj_...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A-101\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"apartment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"price\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`250000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"area\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`110`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"available\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2025-09-01T12:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-29T12:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-unit`,children:`Create a unit`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`POST`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /projects/{projectId}/units`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scope:`}),` `,_jsx(_components.code,{children:`projects:write`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`request-body`,children:`Request body`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"A-101\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"apartment\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"price\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`250000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"area\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`110`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"available\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:`yes`}),_jsx(_components.td,{children:`Free text, ≤ 255 chars.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price`})}),_jsx(_components.td,{children:`yes`}),_jsx(_components.td,{children:`Integer, in the project’s currency.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`type`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`Free text, ≤ 100 chars.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`area`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`Integer (square meters).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`status`})}),_jsx(_components.td,{children:`no`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`available`}),` (default), `,_jsx(_components.code,{children:`reserved`}),`, `,_jsx(_components.code,{children:`sold`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`response-201`,children:`Response 201`}),`\n`,_jsx(_components.p,{children:`Returns the created unit with all its fields.`}),`\n`,_jsx(Heading,{level:`3`,id:`webhook-side-effects`,children:`Webhook side effects`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`unit.created`}),` event is dispatched.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`update-a-unit`,children:`Update a unit`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`PATCH`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` /projects/{projectId}/units/{unitId}`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Scope:`}),` `,_jsx(_components.code,{children:`projects:write`}),`. Partial update. All fields optional, must provide at least one.`]}),`\n`,_jsx(Heading,{level:`3`,id:`request-body-2`,children:`Request body`}),`\n`,_jsxs(_components.p,{children:[`Same fields as create. Pass `,_jsx(_components.code,{children:`null`}),` to clear nullable fields, omit to leave untouched.`]}),`\n`,_jsx(Heading,{level:`3`,id:`response-200-2`,children:`Response 200`}),`\n`,_jsx(_components.p,{children:`Returns the updated unit.`}),`\n`,_jsx(Heading,{level:`3`,id:`webhook-side-effects-2`,children:`Webhook side effects`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Always: `,_jsx(_components.code,{children:`unit.updated`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`If `,_jsx(_components.code,{children:`status`}),` changed: `,_jsx(_components.code,{children:`unit.status_changed`}),`. The payload includes both the unit and its parent project, so receivers don’t need a second API call to know what was sold.`]}),`\n`]}),`\n`,_jsxs(Tip,{children:[`The `,_jsx(_components.code,{children:`unit.status_changed`}),` event is the canonical signal for `,_jsx(_components.strong,{children:`“a unit just became available / reserved / sold”`}),`. Use it to update your website inventory, send Slack notifications, or trigger commission flows.`]})]})}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":"Units","description":"Individual units within a project. Track availability with status: available / reserved / sold.","href":"/api-reference/units"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"List units","slug":"list-units","depth":2,"children":[{"title":"Response 200","slug":"response-200","depth":3,"children":[]}]},{"title":"Create a unit","slug":"create-a-unit","depth":2,"children":[{"title":"Request body","slug":"request-body","depth":3,"children":[]},{"title":"Response 201","slug":"response-201","depth":3,"children":[]},{"title":"Webhook side effects","slug":"webhook-side-effects","depth":3,"children":[]}]},{"title":"Update a unit","slug":"update-a-unit","depth":2,"children":[{"title":"Request body","slug":"request-body-2","depth":3,"children":[]},{"title":"Response 200","slug":"response-200-2","depth":3,"children":[]},{"title":"Webhook side effects","slug":"webhook-side-effects-2","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"flowestate","siteName":"FlowEstate Developers","title":"Units - FlowEstate Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/units","matchLevel":0},"es":{"href":"/es/api-reference/units","matchLevel":1}}},"lastModified":"2026-04-29T20:33:09.144Z","originalFileLocation":"api-reference/units.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Individual units within a project. Track availability with status: available / reserved / sold.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FlowEstate Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_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/flowestate/MgICMXQhbd1W6J6T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Units - FlowEstate Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Individual units within a project. Track availability with status: available / reserved / sold.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FlowEstate Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.flowestate.app/api-reference/units\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://flowestate.mintlify.site/_mintlify/api/og/v2?division=Catalog\u0026amp;title=Units\u0026amp;description=Individual+units+within+a+project.+Track+availability+with+status%3A+available+%2F+reserved+%2F+sold.\u0026amp;theme=3c20f3b766a9e483e07b7cd4\u0026amp;signature=b9b3eb5d6a4ade3c5b34be202c79438ec9d9c6cca4769dce7e53ce75b8108952\">\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=\"Units - FlowEstate Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Individual units within a project. Track availability with status: available / reserved / sold.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://flowestate.mintlify.site/_mintlify/api/og/v2?division=Catalog\u0026amp;title=Units\u0026amp;description=Individual+units+within+a+project.+Track+availability+with+status%3A+available+%2F+reserved+%2F+sold.\u0026amp;theme=3c20f3b766a9e483e07b7cd4\u0026amp;signature=b9b3eb5d6a4ade3c5b34be202c79438ec9d9c6cca4769dce7e53ce75b8108952\">\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/flowestate/MgICMXQhbd1W6J6T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FlowEstate Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3066B6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.flowestate.app/api-reference/units\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/units.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://developers.flowestate.app/api-reference/units\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://developers.flowestate.app/es/api-reference/units\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://developers.flowestate.app/api-reference/units\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.flowestate.app/#organization\",\"name\":\"FlowEstate Developers\",\"url\":\"https://developers.flowestate.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/flowestate/ksRHPKktoRN6u81O/logo/light.svg?fit=max\u0026auto=format\u0026n=ksRHPKktoRN6u81O\u0026q=85\u0026s=5c2fb629132bfb174396224c285666dc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.flowestate.app#website\",\"name\":\"FlowEstate Developers\",\"url\":\"https://developers.flowestate.app\",\"publisher\":{\"@id\":\"https://developers.flowestate.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.flowestate.app/api-reference/units#webpage\",\"url\":\"https://developers.flowestate.app/api-reference/units\",\"name\":\"Units\",\"description\":\"Individual units within a project. Track availability with status: available / reserved / sold.\",\"dateModified\":\"2026-04-29T20:33:09.144Z\",\"isPartOf\":{\"@id\":\"https://developers.flowestate.app#website\"},\"breadcrumb\":{\"@id\":\"https://developers.flowestate.app/api-reference/units#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.flowestate.app/api-reference/units#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Catalog\",\"item\":\"https://developers.flowestate.app/api-reference/projects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Units\",\"item\":\"https://developers.flowestate.app/api-reference/units\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.flowestate.app/api-reference/units#article\",\"headline\":\"Units\",\"name\":\"Units\",\"description\":\"Individual units within a project. Track availability with status: available / reserved / sold.\",\"url\":\"https://developers.flowestate.app/api-reference/units\",\"mainEntityOfPage\":{\"@id\":\"https://developers.flowestate.app/api-reference/units#webpage\"},\"dateModified\":\"2026-04-29T20:33:09.144Z\",\"publisher\":{\"@id\":\"https://developers.flowestate.app/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.flowestate.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FlowEstate Developers\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FlowEstate Developers\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/units.md","siteName":"FlowEstate Developers","nav":{"global":{"anchors":[{"anchor":"Status","icon":"signal-bars","href":"https://status.flowestate.app"},{"anchor":"Support","icon":"envelope","href":"mailto:soporte@flowestate.app"}]},"languages":[{"language":"en","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference overview","href":"/api-reference/overview"},{"title":"Connection check","href":"/api-reference/connection"}]},{"group":"Leads","pages":[{"title":"Leads","href":"/api-reference/leads"},{"title":"Lead sources","href":"/api-reference/lead-sources"},{"title":"Pipeline stages","href":"/api-reference/pipeline"}]},{"group":"Catalog","pages":[{"title":"Projects","description":"Manage your real-estate catalog at the project level. CRUD operations on the parent of units.","href":"/api-reference/projects"},{"title":"Units","href":"/api-reference/units"}]},{"group":"Organization","pages":[{"title":"Members","description":"List the people in your FlowEstate organization.","href":"/api-reference/members"}]},{"group":"Automation","pages":[{"title":"Round robin","href":"/api-reference/round-robin"},{"title":"Calendar","href":"/api-reference/calendar"},{"title":"Sequences","href":"/api-reference/sequences"},{"title":"WhatsApp","href":"/api-reference/whatsapp"}]},{"group":"Webhooks","pages":[{"title":"Webhook subscriptions","href":"/api-reference/webhooks"}]}]}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/units"}]}]},"basePath":"","title":"Units - FlowEstate Developers","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}