Reference for service account permission scopes and operations
Each service account defines access through per-scope permissions. Permissions are classified as Read or Write and determine what the integration can do with each resource. After creating a service account, open its Permissions page to define access. Use the permissions reference below to see what scopes and operations are available.
Enable only the permissions your integration requires. Granting broader access than necessary increases your security surface area.
General
Basic building information such as name, address, and configuration.
Hide General
Read
Retrieve basic building information such as name, address, and configuration details.
Actions
Building actions such as automated commands or system-level responses.
Hide Actions
Read
Retrieve building actions, such as automated commands or system-level responses.
AreasPublic
Building areas such as floors, wings, or common spaces.
Hide AreasPublic
Read
Retrieve building areas, such as floors, wings, or common spaces.
DatasourcesPublic
Data source configurations such as BMS integrations or IoT gateways.
Hide DatasourcesPublic
Read
Retrieve data source configurations, such as BMS integrations or IoT gateways.
DevicesPublic
Devices such as controllers, sensors, or actuators connected through a data source.
Hide DevicesPublic
Read
Retrieve device data, such as controllers, sensors, or actuators connected through a data source.
Write
Create new devices.
MetersPublic
Meters and meter assignments for energy or utility tracking.
Hide MetersPublic
Read
Retrieve a single meter.
Read
Retrieve every meter in the building.
Write
Assign a meter to a resource.
Write
Create a meter reference.
Write
Remove a meter.
Write
Remove a meter assignment.
Write
Remove a meter reference.
Write
Modify an existing meter.
PointsPublic
Data points such as temperature readings, set points, or equipment status values.
Hide PointsPublic
Read
Retrieve data points, such as temperature readings, set points, or equipment status values.
Write
Create new data points.
SpacesPublic
Spaces and their meter associations within a building.
Hide SpacesPublic
Read
Retrieve a single space.
Read
Retrieve meter data for a space.
Read
Retrieve all spaces.
Write
Create multiple spaces at once.
Write
Update multiple spaces at once.
Write
Create a single space.
Write
Modify an existing space.
TenantsPublic
Tenants and tenant assignments for the building.
Hide TenantsPublic
Read
Retrieve a single tenant.
Read
Retrieve tenant assignments.
Read
Retrieve all tenants.
Write
Create a new tenant.
Write
Remove a tenant.
Write
Modify an existing tenant.
TimeseriesPublic
Time-series data for trend analysis, reporting, and energy calculations.
Hide TimeseriesPublic
Read
Retrieve time-series data for trend analysis, reporting, and energy calculations.
Write
Write new time-series data.
WorkOrdersPublic
Work orders for maintenance tasks, repair requests, and scheduled activities.
Hide WorkOrdersPublic
Read
Retrieve work orders for maintenance tasks, repair requests, and scheduled activities.
Write
Create new work orders.
Last modified on April 7, 2026
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"KODE Labs - Product Documentation","colors":{"primary":"#015BFA","light":"#3A9AFF","dark":"#015BFA"},"logo":{"light":"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-light.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=00d4ffd6ad7a592e52856804d1a53d12","dark":"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=a6769f53904d96f5a53ea0c4b3c972d6","href":"/"},"favicon":{"light":"https://mintcdn.com/kodelabs/H3HEEQdnaG21O57-/logo/favicon-light.png?fit=max\u0026auto=format\u0026n=H3HEEQdnaG21O57-\u0026q=85\u0026s=3ae881e353dfb5c2f667e175ec82c799","dark":"https://mintcdn.com/kodelabs/H3HEEQdnaG21O57-/logo/favicon-dark.png?fit=max\u0026auto=format\u0026n=H3HEEQdnaG21O57-\u0026q=85\u0026s=845431bc7d53ce5bf50f56ef53d9137f"},"api":{"params":{"expanded":"closed"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["bash","javascript","python","powershell"],"prefill":true,"autogenerate":true},"url":"full"},"appearance":{"default":"light","strict":true},"background":{"color":{"light":"#ffffff","dark":"#121212"}},"navbar":{"links":[{"href":"https://kodelabs.com/contact/","label":"Contact Us"}]},"footer":{"socials":{"x":"https://twitter.com/kodelabs","instagram":"https://www.instagram.com/kode_labs","linkedin":"https://www.linkedin.com/company/kodelabs","youtube":"https://www.youtube.com/channel/UCKCnsgnYtugWxMPzu3UEHkw"},"links":[{"header":"Platform","items":[{"label":"KODE OS","href":"https://kodelabs.com"},{"label":"Integrations","href":"https://kodelabs.com/partners/integrations-library"},{"label":"Security","href":"https://kodelabs.com/security"}]},{"header":"Resources","items":[{"label":"Blog","href":"https://kodelabs.com/blog"},{"label":"Reports \u0026 Guides","href":"https://kodelabs.com/resources"},{"label":"Podcasts \u0026 Webinars","href":"https://kodelabs.com/resources"},{"label":"Case Studies","href":"https://kodelabs.com/case-studies"},{"label":"News","href":"https://kodelabs.com/news"}]},{"header":"Solutions","items":[{"label":"Commercial","href":"https://kodelabs.com/solutions/commercial-real-estate"},{"label":"Corporate","href":"https://kodelabs.com/solutions/corporate"},{"label":"Retail","href":"https://kodelabs.com/solutions/retail"},{"label":"Healthcare","href":"https://kodelabs.com/solutions/healthcare"},{"label":"Education","href":"https://kodelabs.com/solutions/education"}]},{"header":"Company","items":[{"label":"About","href":"https://kodelabs.com/about"},{"label":"Careers","href":"https://kodelabs.com/careers"},{"label":"Internships","href":"https://kodelabs.com/internships"},{"label":"Contact Us","href":"https://kodelabs.com/contact"}]}]},"search":{"prompt":"Search our docs..."},"fonts":{"heading":{"family":"Manrope","weight":600},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"integrations":{"ga4":{"measurementId":"G-WKYQEE1T4B"}},"banner":{"content":"KODE 3.20 is live. See [what's new in November 2026](/whats-new/2026/v3.20-november-2026).","dismissible":true,"color":{"light":"#015BFA","dark":"#015BFA"}},"errors":{"404":{"redirect":false,"title":"We're working on it!","description":"If you're not seeing this page, we're definitely updating it."}},"contextual":{"options":["copy","view",{"title":"Email KODE support","description":"Contact KODE Labs support for help","icon":"mail","href":"mailto:support@kodelabs.com"}],"display":"toc"},"interaction":{"drilldown":false},"metadata":{"timestamp":true},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"},{"anchor":"What's New","icon":"megaphone","href":"/whats-new/2026/v3.20-november-2026"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"kodelabs","hasAudioNarration":false,"actualSubdomain":"kodelabs","customDomains":["docs.kodelabs.com"],"gitSource":{"type":"github","owner":"kode-labs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af8e4f300819710da52c87a","clientVersion":"0.0.4263","searchFilterCounts":[{"language":"default","tag":"Integrations","count":214},{"language":"default","tag":"All Integrations","count":205},{"language":"default","tag":"KODE API","count":143},{"language":"default","tag":"API reference","count":132},{"language":"default","tag":"EnerG","count":61},{"language":"default","tag":"Meters","count":37},{"language":"default","tag":"Building BI","count":35},{"language":"default","tag":"AssetOps","count":32},{"language":"default","tag":"Cloud BMS","count":31},{"language":"default","tag":"Reference","count":29}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":true,"maxResults":10}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"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":"site-roles","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},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","href":"/_mintlify/custom/kodelabs/fd6257d3326e3afa/custom.css"}]}
{"page":{"pagePath":"products/launchpad/client-organizations/service-accounts/permissions-reference","slug":"/products/launchpad/client-organizations/service-accounts/permissions-reference","pageMetadata":{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","description":"Reference for service account permission scopes and operations","icon":"dot","keywords":["service account","permissions","Read","Write","Launchpad","API"],"href":"/products/launchpad/client-organizations/service-accounts/permissions-reference"},"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: \"Reference for service account permission scopes and operations\"\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Expandable,Heading,Note,ParamField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Each service account defines access through per-scope permissions. Permissions are classified as `,_jsx(_components.code,{children:`Read`}),` or `,_jsx(_components.code,{children:`Write`}),` and determine what the integration can do with each resource. After creating a service account, open its `,_jsx(_components.strong,{children:`Permissions`}),` page to define access. Use the permissions reference below to see what scopes and operations are available.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Enable only the permissions your integration requires. Granting broader access than necessary increases your security surface area.`})}),`\n`,_jsx(Heading,{level:`3`,id:`general`,children:`General`}),`\n`,_jsx(_components.p,{children:`Basic building information such as name, address, and configuration.`}),`\n`,_jsx(Expandable,{title:`General`,defaultOpen:true,children:_jsx(ParamField,{path:`Get Buildings`,type:`Read`,id:`param-get-buildings`,children:_jsx(_components.p,{children:`Retrieve basic building information such as name, address, and configuration details.`})})}),`\n`,_jsx(Heading,{level:`3`,id:`actions`,children:`Actions`}),`\n`,_jsx(_components.p,{children:`Building actions such as automated commands or system-level responses.`}),`\n`,_jsx(Expandable,{title:`Actions`,defaultOpen:true,children:_jsx(ParamField,{path:`Get Actions`,type:`Read`,id:`param-get-actions`,children:_jsx(_components.p,{children:`Retrieve building actions, such as automated commands or system-level responses.`})})}),`\n`,_jsx(Heading,{level:`3`,id:`areaspublic`,children:`AreasPublic`}),`\n`,_jsx(_components.p,{children:`Building areas such as floors, wings, or common spaces.`}),`\n`,_jsx(Expandable,{title:`AreasPublic`,defaultOpen:true,children:_jsx(ParamField,{path:`Get areas`,type:`Read`,id:`param-get-areas`,children:_jsx(_components.p,{children:`Retrieve building areas, such as floors, wings, or common spaces.`})})}),`\n`,_jsx(Heading,{level:`3`,id:`datasourcespublic`,children:`DatasourcesPublic`}),`\n`,_jsx(_components.p,{children:`Data source configurations such as BMS integrations or IoT gateways.`}),`\n`,_jsx(Expandable,{title:`DatasourcesPublic`,defaultOpen:true,children:_jsx(ParamField,{path:`Get Datasources`,type:`Read`,id:`param-get-datasources`,children:_jsx(_components.p,{children:`Retrieve data source configurations, such as BMS integrations or IoT gateways.`})})}),`\n`,_jsx(Heading,{level:`3`,id:`devicespublic`,children:`DevicesPublic`}),`\n`,_jsx(_components.p,{children:`Devices such as controllers, sensors, or actuators connected through a data source.`}),`\n`,_jsxs(Expandable,{title:`DevicesPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get devices`,type:`Read`,id:`param-get-devices`,children:_jsx(_components.p,{children:`Retrieve device data, such as controllers, sensors, or actuators connected through a data source.`})}),_jsx(ParamField,{path:`Create Devices`,type:`Write`,id:`param-create-devices`,children:_jsx(_components.p,{children:`Create new devices.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`meterspublic`,children:`MetersPublic`}),`\n`,_jsx(_components.p,{children:`Meters and meter assignments for energy or utility tracking.`}),`\n`,_jsxs(Expandable,{title:`MetersPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get meter`,type:`Read`,id:`param-get-meter`,children:_jsx(_components.p,{children:`Retrieve a single meter.`})}),_jsx(ParamField,{path:`List meters`,type:`Read`,id:`param-list-meters`,children:_jsx(_components.p,{children:`Retrieve every meter in the building.`})}),_jsx(ParamField,{path:`Create meter assignment`,type:`Write`,id:`param-create-meter-assignment`,children:_jsx(_components.p,{children:`Assign a meter to a resource.`})}),_jsx(ParamField,{path:`Create meter reference`,type:`Write`,id:`param-create-meter-reference`,children:_jsx(_components.p,{children:`Create a meter reference.`})}),_jsx(ParamField,{path:`Delete meter`,type:`Write`,id:`param-delete-meter`,children:_jsx(_components.p,{children:`Remove a meter.`})}),_jsx(ParamField,{path:`Delete meter assignment`,type:`Write`,id:`param-delete-meter-assignment`,children:_jsx(_components.p,{children:`Remove a meter assignment.`})}),_jsx(ParamField,{path:`Delete meter reference`,type:`Write`,id:`param-delete-meter-reference`,children:_jsx(_components.p,{children:`Remove a meter reference.`})}),_jsx(ParamField,{path:`Update meter`,type:`Write`,id:`param-update-meter`,children:_jsx(_components.p,{children:`Modify an existing meter.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`pointspublic`,children:`PointsPublic`}),`\n`,_jsx(_components.p,{children:`Data points such as temperature readings, set points, or equipment status values.`}),`\n`,_jsxs(Expandable,{title:`PointsPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get points`,type:`Read`,id:`param-get-points`,children:_jsx(_components.p,{children:`Retrieve data points, such as temperature readings, set points, or equipment status values.`})}),_jsx(ParamField,{path:`Create Points`,type:`Write`,id:`param-create-points`,children:_jsx(_components.p,{children:`Create new data points.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`spacespublic`,children:`SpacesPublic`}),`\n`,_jsx(_components.p,{children:`Spaces and their meter associations within a building.`}),`\n`,_jsxs(Expandable,{title:`SpacesPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get space`,type:`Read`,id:`param-get-space`,children:_jsx(_components.p,{children:`Retrieve a single space.`})}),_jsx(ParamField,{path:`Get space meters`,type:`Read`,id:`param-get-space-meters`,children:_jsx(_components.p,{children:`Retrieve meter data for a space.`})}),_jsx(ParamField,{path:`List spaces`,type:`Read`,id:`param-list-spaces`,children:_jsx(_components.p,{children:`Retrieve all spaces.`})}),_jsx(ParamField,{path:`Batch create spaces`,type:`Write`,id:`param-batch-create-spaces`,children:_jsx(_components.p,{children:`Create multiple spaces at once.`})}),_jsx(ParamField,{path:`Batch update spaces`,type:`Write`,id:`param-batch-update-spaces`,children:_jsx(_components.p,{children:`Update multiple spaces at once.`})}),_jsx(ParamField,{path:`Create space`,type:`Write`,id:`param-create-space`,children:_jsx(_components.p,{children:`Create a single space.`})}),_jsx(ParamField,{path:`Update space`,type:`Write`,id:`param-update-space`,children:_jsx(_components.p,{children:`Modify an existing space.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`tenantspublic`,children:`TenantsPublic`}),`\n`,_jsx(_components.p,{children:`Tenants and tenant assignments for the building.`}),`\n`,_jsxs(Expandable,{title:`TenantsPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get tenant`,type:`Read`,id:`param-get-tenant`,children:_jsx(_components.p,{children:`Retrieve a single tenant.`})}),_jsx(ParamField,{path:`Get tenant assignments`,type:`Read`,id:`param-get-tenant-assignments`,children:_jsx(_components.p,{children:`Retrieve tenant assignments.`})}),_jsx(ParamField,{path:`List tenants`,type:`Read`,id:`param-list-tenants`,children:_jsx(_components.p,{children:`Retrieve all tenants.`})}),_jsx(ParamField,{path:`Create tenant`,type:`Write`,id:`param-create-tenant`,children:_jsx(_components.p,{children:`Create a new tenant.`})}),_jsx(ParamField,{path:`Delete tenant`,type:`Write`,id:`param-delete-tenant`,children:_jsx(_components.p,{children:`Remove a tenant.`})}),_jsx(ParamField,{path:`Update tenant`,type:`Write`,id:`param-update-tenant`,children:_jsx(_components.p,{children:`Modify an existing tenant.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`timeseriespublic`,children:`TimeseriesPublic`}),`\n`,_jsx(_components.p,{children:`Time-series data for trend analysis, reporting, and energy calculations.`}),`\n`,_jsxs(Expandable,{title:`TimeseriesPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get Timeseries`,type:`Read`,id:`param-get-timeseries`,children:_jsx(_components.p,{children:`Retrieve time-series data for trend analysis, reporting, and energy calculations.`})}),_jsx(ParamField,{path:`Create Timeseries`,type:`Write`,id:`param-create-timeseries`,children:_jsx(_components.p,{children:`Write new time-series data.`})})]}),`\n`,_jsx(Heading,{level:`3`,id:`workorderspublic`,children:`WorkOrdersPublic`}),`\n`,_jsx(_components.p,{children:`Work orders for maintenance tasks, repair requests, and scheduled activities.`}),`\n`,_jsxs(Expandable,{title:`WorkOrdersPublic`,defaultOpen:true,children:[_jsx(ParamField,{path:`Get WorkOrders`,type:`Read`,id:`param-get-work-orders`,children:_jsx(_components.p,{children:`Retrieve work orders for maintenance tasks, repair requests, and scheduled activities.`})}),_jsx(ParamField,{path:`Create WorkOrders`,type:`Write`,id:`param-create-work-orders`,children:_jsx(_components.p,{children:`Create new work orders.`})})]})]})}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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","description":"Reference for service account permission scopes and operations","icon":"dot","keywords":["service account","permissions","Read","Write","Launchpad","API"],"href":"/products/launchpad/client-organizations/service-accounts/permissions-reference"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"General","slug":"general","depth":3,"children":[]},{"title":"Actions","slug":"actions","depth":3,"children":[]},{"title":"AreasPublic","slug":"areaspublic","depth":3,"children":[]},{"title":"DatasourcesPublic","slug":"datasourcespublic","depth":3,"children":[]},{"title":"DevicesPublic","slug":"devicespublic","depth":3,"children":[]},{"title":"MetersPublic","slug":"meterspublic","depth":3,"children":[]},{"title":"PointsPublic","slug":"pointspublic","depth":3,"children":[]},{"title":"SpacesPublic","slug":"spacespublic","depth":3,"children":[]},{"title":"TenantsPublic","slug":"tenantspublic","depth":3,"children":[]},{"title":"TimeseriesPublic","slug":"timeseriespublic","depth":3,"children":[]},{"title":"WorkOrdersPublic","slug":"workorderspublic","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/kodelabs/ce5d3bd08e955b7b/navbar-assistant.js"],"subdomain":"kodelabs","siteName":"KODE Labs - Product Documentation","title":"Permissions Reference - KODE Labs - Product Documentation","contextualStarterQuestions":[{"_id":"6a88bbaf1af966f81de145ff","deploymentId":"67fd4d9635f314f3a994be65","questionText":"How do I limit integration access?","status":"active","generatedBy":"contextual","path":"products/launchpad/client-organizations/service-accounts/permissions-reference","createdAt":"2026-08-21T20:57:19.671Z","updatedAt":"2026-08-21T20:57:19.671Z","__v":0},{"_id":"6a88bbaf1af966f81de145fd","deploymentId":"67fd4d9635f314f3a994be65","questionText":"How do I set service permissions?","status":"active","generatedBy":"contextual","path":"products/launchpad/client-organizations/service-accounts/permissions-reference","createdAt":"2026-08-21T20:57:19.671Z","updatedAt":"2026-08-21T20:57:19.671Z","__v":0},{"_id":"6a88bbaf1af966f81de145fe","deploymentId":"67fd4d9635f314f3a994be65","questionText":"What permission scopes exist?","status":"active","generatedBy":"contextual","path":"products/launchpad/client-organizations/service-accounts/permissions-reference","createdAt":"2026-08-21T20:57:19.671Z","updatedAt":"2026-08-21T20:57:19.671Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{},"searchTabScopes":[]},"lastModified":"2026-04-07T12:43:40.470Z","gitLastModified":"2026-04-07T12:43:00.000Z","originalFileLocation":"products/launchpad/client-organizations/service-accounts/permissions-reference.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"Reference for service account permission scopes and operations\">\u003cmeta data-mint-head name=\"application-name\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Permissions Reference - KODE Labs - Product Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reference for service account permission scopes and operations\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://kodelabs.mintlify.site/_mintlify/api/og/v2?division=Service+Accounts\u0026amp;title=Permissions+Reference\u0026amp;description=Reference+for+service+account+permission+scopes+and+operations\u0026amp;theme=ac252318c016362b89abdbd3\u0026amp;signature=8a286656b0b9e47a4c01307fc35bdaf07c7c2a601c58d484a1f89d65548faefe\">\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=\"Permissions Reference - KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reference for service account permission scopes and operations\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://kodelabs.mintlify.site/_mintlify/api/og/v2?division=Service+Accounts\u0026amp;title=Permissions+Reference\u0026amp;description=Reference+for+service+account+permission+scopes+and+operations\u0026amp;theme=ac252318c016362b89abdbd3\u0026amp;signature=8a286656b0b9e47a4c01307fc35bdaf07c7c2a601c58d484a1f89d65548faefe\">\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/kodelabs/vtcGE1gj2AkAE1l2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"KODE Labs - Product Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#015BFA\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/launchpad/client-organizations/service-accounts/permissions-reference.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.kodelabs.com/#organization\",\"name\":\"KODE Labs - Product Documentation\",\"url\":\"https://docs.kodelabs.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/kodelabs/YfYud6Al4TM68wc2/logo/logo-light.png?fit=max\u0026auto=format\u0026n=YfYud6Al4TM68wc2\u0026q=85\u0026s=00d4ffd6ad7a592e52856804d1a53d12\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.kodelabs.com#website\",\"name\":\"KODE Labs - Product Documentation\",\"url\":\"https://docs.kodelabs.com\",\"publisher\":{\"@id\":\"https://docs.kodelabs.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference#webpage\",\"url\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference\",\"name\":\"Permissions Reference\",\"description\":\"Reference for service account permission scopes and operations\",\"dateModified\":\"2026-04-07T12:43:00.000Z\",\"isPartOf\":{\"@id\":\"https://docs.kodelabs.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Client Organizations\",\"item\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/client-organization-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Service Accounts\",\"item\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Permissions Reference\",\"item\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference#article\",\"headline\":\"Permissions Reference\",\"name\":\"Permissions Reference\",\"description\":\"Reference for service account permission scopes and operations\",\"url\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference\",\"mainEntityOfPage\":{\"@id\":\"https://docs.kodelabs.com/products/launchpad/client-organizations/service-accounts/permissions-reference#webpage\"},\"dateModified\":\"2026-04-07T12:43:00.000Z\",\"keywords\":\"service account, permissions, Read, Write, Launchpad, API\",\"publisher\":{\"@id\":\"https://docs.kodelabs.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.kodelabs.com#website\"}}]}\u003c/script>","agentPointerHref":"/products/launchpad/client-organizations/service-accounts/permissions-reference.md","siteName":"KODE Labs - Product Documentation","nav":{"global":{"anchors":[{"anchor":"Home","icon":"house","href":"/"},{"anchor":"What's New","icon":"megaphone","href":"/whats-new/2026/v3.20-november-2026"}]},"products":[{"product":"Cloud BMS","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/cloud-bms.svg","description":"Cloud building management, graphics, and control","pages":[{"title":"Cloud BMS","href":"/products/kode-os/get-started/introduction"}]},{"product":"Building BI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/bbi.svg","description":"Dashboards and analytics for building performance","pages":[{"title":"Building BI","href":"/products/building-bi/overview"}]},{"product":"FDD","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/fdd.svg","description":"Fault detection and diagnostics for equipment","pages":[{"title":"FDD","href":"/products/fdd/overview"}]},{"product":"FTT","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/ftt.svg","description":"Automated functional testing and commissioning","pages":[{"title":"FTT","href":"/products/ftt/overview"}]},{"product":"AssetOps","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/assetops.svg","description":"Asset and maintenance operations","pages":[{"title":"AssetOps","href":"/products/assetops/quickstart/overview"}]},{"product":"EnerG","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/enerG.svg","description":"Energy management and sustainability reporting","pages":[{"title":"EnerG","href":"/products/energ/get-started/introduction"}]},{"product":"Launchpad","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/launchpad.svg","description":"Dynamic management for apps, users, and buildings","groups":[{"group":"Get Started","pages":[{"title":"What's Launchpad?","sidebarTitle":"Introduction","icon":"rocket","href":"/products/launchpad/get-started/introduction"},{"title":"Provisioning Architecture","sidebarTitle":"Provisioning Architecture","icon":"git-branch","href":"/products/launchpad/get-started/provisioning-architecture"},{"title":"Accounts and Users","sidebarTitle":"Accounts and Users","icon":"users","href":"/products/launchpad/get-started/accounts-and-users"},{"title":"Workspaces \u0026 Sign-In","sidebarTitle":"Workspaces \u0026 Sign-In","icon":"log-in","href":"/products/launchpad/get-started/workspaces-and-sign-in"},{"title":"Configure Single Sign-On (SSO)","sidebarTitle":"Configure SSO","icon":"key","href":"/products/launchpad/get-started/configure-single-sign-on-sso"},{"title":"Security Settings","sidebarTitle":"Security Settings","icon":"shield","href":"/products/launchpad/get-started/security-settings"}]},{"group":"Channel Partners","pages":[{"title":"Channel Partners","sidebarTitle":"Overview","icon":"book-open","href":"/products/launchpad/channel-partners/channel-partner-overview"},{"title":"Clients","sidebarTitle":"Manage Clients","icon":"cog","href":"/products/launchpad/channel-partners/clients"},{"title":"Users","sidebarTitle":"Manage Users","icon":"cog","href":"/products/launchpad/channel-partners/users"},{"title":"Product Enablement","sidebarTitle":"Product Enablement","icon":"box","href":"/products/launchpad/channel-partners/product-enablement"}]},{"group":"Client Organizations","pages":[{"title":"Client Organizations","sidebarTitle":"Overview","icon":"book-open","href":"/products/launchpad/client-organizations/client-organization-overview"},{"title":"Users","sidebarTitle":"Manage Users","icon":"cog","href":"/products/launchpad/client-organizations/users"},{"title":"Buildings","sidebarTitle":"Manage Buildings","icon":"cog","href":"/products/launchpad/client-organizations/buildings"},{"group":"Apps","icon":"app-store","pages":[{"title":"Apps (KODE OS)","sidebarTitle":"Overview","icon":"dot","tag":"KODE OS","href":"/products/launchpad/client-organizations/apps"},{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","icon":"dot","href":"/products/launchpad/client-organizations/apps/permissions-reference"}]},{"group":"Service Accounts","icon":"webhook","pages":[{"title":"Service Accounts","sidebarTitle":"Overview","description":"Create and manage Launchpad service accounts for KODE API integrations with OAuth 2.0 credentials and permissions.","icon":"dot","href":"/products/launchpad/client-organizations/service-accounts"},{"title":"Permissions Reference","sidebarTitle":"Permissions Reference","icon":"dot","href":"/products/launchpad/client-organizations/service-accounts/permissions-reference"}]}]},{"group":"Reference","icon":"book-a","pages":[{"title":"KODE glossary","sidebarTitle":"Glossary","description":"Definitions of common KODE Labs terms across Cloud BMS, Launchpad, Building BI, AssetOps, EnerG, FDD, FTT, and related products.","icon":"book-a","href":"/products/launchpad/glossary"}]}]},{"product":"Mobile app","icon":"https://mintlify.s3.us-west-1.amazonaws.com/kodelabs/images/mobile-app.svg","description":"Monitor and operate buildings from iOS and Android","pages":[{"title":"Mobile app","href":"/products/mobile-app/overview"}]},{"product":"KODE API","icon":"braces","description":"Build services and integrations with KODE OS","pages":[{"title":"KODE API","href":"/products/kode-api"}]},{"product":"Integrations","icon":"cable","description":"Connect 200+ building systems to KODE OS","pages":[{"title":"Integrations","href":"/products/integrations/get-started/introduction"}]},{"product":"What's New","icon":"megaphone","description":"KODE platform release notes and updates","pages":[{"title":"What's New","href":"/whats-new/2026/v3.20-november-2026"}]}]},"basePath":"","title":"Permissions Reference - KODE Labs - Product Documentation","deploymentId":"dpl_7AgmPo2RyRWZ68ZGceW618SWGEAz","buildId":"dpl_7AgmPo2RyRWZ68ZGceW618SWGEAz","dynamics":["10e4515597"],"chunks":["BannerMarkdown-Cc6DT3k_.js","dist-BbIWfytJ.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}