Aurora uses Access Scopes to define how external apps and services can access data in your tenant. Each access scope defines an ability to either read or modify data in your tenant based on a set of Aurora API endpoints. For instance, the read_projects scope will give apps the ability to retrieve basic information about a project, see assets of a project, and retrieve AHJ information for a project.
For the exact data exposed for each access scope, see the API documentation for the relevant endpoints at docs.aurorasolar.com
All Access Scopes
For a list of all access scopes, and what endpoints fall under each scope, please see below:
| Scope | API Endpoints
|
|---|---|
| read_tenants | Retrieve Tenant |
| read_versions | Retrieve Versions |
| write_versions | Upgrade Version, Rollback Version |
| read_users | Retrieve User, List Roles |
| list_users | List Users |
| write_users | Create User, Invite User, Update User, Activate User, Deactivate User |
| read_sso_providers | Retrieve SSO Provider |
| write_sso_providers | Create SSO Provider, Update SSO Provider |
| read_teams | List Teams |
| read_partners | List Partners, Retrieve Partner |
| write_partners | Create Partner, Update Partner, Add Users to Partner, Update Partner Users, Upload Partner Logo |
| read_consumer_orders | List Orders, Retrieve Order |
| write_consumer_orders | Update Order, Decline Order, Mark Order Sold |
| read_projects | Retrieve Project, List Project Assets, Retrieve AHJ, Retrieve Project Bill Summary |
| list_projects | List Projects |
| write_projects | Create Project, Update Project, Delete Project, Create Project Asset, Convert Order to Project, Retrieve Convert Order to Project Status |
| read_consumption_profiles | Retrieve Consumption Profile, List Utility Bills, Retrieve Utility Bill |
| write_consumption_profiles | Update Consumption Profile, Run Utility Bill Upload, Retrieve Utility Bill Upload Status |
| read_design_requests | List Design Requests, Retrieve Design Request, Retrieve EagleView Design Request |
| write_design_requests | Create Design Request, Accept Design Request, Create EagleView Design Request, Accept EagleView Design Request |
| read_designs | List Designs, Retrieve Design, Retrieve Design Summary, Retrieve Roof Summary, List Racking Arrays, Retrieve Web Proposal, Retrieve Proposal PDF Generation, Retrieve AI Roof Status, Retrieve Design Bill Summary |
| write_designs | Create Design, Duplicate Design, Generate Web Proposal URL, Update Racking Bill of Materials, Update Design, Run Proposal PDF Generation, Run AI Roof |
| read_design_assets | List Design Assets, Retrieve Design Asset |
| write_design_assets | Create Design Asset |
| read_components | List Modules, Retrieve Module, List Inverters, Retrieve Inverter, List DC Optimizers, Retrieve DC Optimizer |
| read_pricing | Retrieve Design Pricing |
| write_pricing | Update Design Pricing, Create Adder, Delete Adder |
| read_financing | List Financings, Retrieve Financing |
| write_financing | Push Financing to Financier |
| read_proposals | List Proposal Templates, Retrieve Proposal Template, Retrieve Proposal |
| write_proposals | Create Proposal, Delete Proposal |
| read_agreements | List Agreements, Retrieve Agreement, Retrieve Agreement Link, Run Agreement Download URL Generation, Retrieve Agreement Download URL |
| read_site_surveys | Retrieve Site Survey Request, Retrieve Site Survey, List Site Surveys |
| write_site_surveys | Create Site Survey, Update Site Survey Overview, Update Site Survey Electrical Data, Update Site Survey Electrical Subpanels, Update Site Survey Mounting Planes, Update Site Survey Status |
| read_plan_sets | Retrieve Plan Set Request, Retrieve Plan Set |
| write_plan_sets | Create Plan Set Request |
| read_webhooks | List Webhooks, Retrieve Webhook |
| write_webhooks | Create Webhook, Update Webhook, Delete Webhook |
| read_shared_projects | List Shared Projects |
| write_project_records | Share Milestone |
| read_project_notes | Retrieve Project Note, Retrieve Project Note Files |
| write_project_notes | Create Project Note, Update Project Note |
| run_design_automation | Run Fire Pathway Placement, Retrieve Fire Pathway Placement Status, Run AutoDesigner, Retrieve AutoDesigner Status, Run Irradiance Analysis, Retrieve Irradiance Analysis Status, Run Performance Simulation, Retrieve Performance Simulation Status |