> ## Documentation Index
> Fetch the complete documentation index at: https://developers.podero.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Current App Settings

> The app settings of the organization the request names: which tabs and controls the app
shows, its stored switches, and the device brands and categories its members may connect.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json get /api/partners/v2.0/app-settings/current
openapi: 3.1.0
info:
  title: Podero Partner API
  version: '2.0'
  description: >-
    This API provides a unified interaction point for Podero's partner
    companies.


    The goal of this API is to give partners easily integratable endpoints that
    don't require extensive software

    development. For this reason, the endpoints focus around user and device
    management, setting of preferences

    and high level device controls.


    While direct control of devices is implemented for special use cases such as
    pause power, we abstract away low level

    direct device steering so developers and partners can focus on delivering
    maximum value to end users.


    ## Authentication


    Send an OAuth2 access token in the `Authorization: Bearer <access_token>`
    header of each request.

    A token request must have a JSON body. The token endpoints do not read a
    form-encoded body.


    Server-to-server integrations use the client credentials grant:


    ```http

    POST /oauth2/token/

    Authorization: Basic base64(<client_id>:<client_secret>)

    Content-Type: application/json


    {"grant_type": "client_credentials"}

    ```


    The response does not contain a refresh token. The access token expires
    after `expires_in` seconds (one hour).

    To renew it, send the same request again. Use one token for all requests
    until shortly before it expires.

    Do not request a new token for each request. If a request returns `401`, get
    one new token and send the request

    again once. If it returns `401` again, the token is valid but the
    application has no access to that resource,

    and a new token does not change that.


    Apps where a person signs in use the password grant at `POST
    /api/partners/v2.0/auth/token`, and renew the

    session with the `refresh_token` grant at the same endpoint.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/app-settings/current:
    get:
      tags:
        - Organization Branding
      summary: Current App Settings
      description: >-
        The app settings of the organization the request names: which tabs and
        controls the app

        shows, its stored switches, and the device brands and categories its
        members may connect.
      operationId: integrations_api_api_v2_current_organization_router_current_app_settings
      parameters:
        - in: query
          name: onboarding_session_id
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Onboarding Session Id
          required: false
        - in: query
          name: invite_token
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Invite Token
          required: false
        - in: query
          name: signup_token
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Signup Token
          required: false
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppSettingsDocument'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolutionFailure'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResolutionFailure'
components:
  schemas:
    AppSettingsDocument:
      properties:
        app_config:
          $ref: '#/components/schemas/AppConfig'
        feature_flags:
          $ref: '#/components/schemas/AppFeatureFlags'
        brands:
          items:
            $ref: '#/components/schemas/DeviceBrand'
          title: Brands
          type: array
        device_types:
          items:
            type: string
          title: Device Types
          type: array
      required:
        - app_config
        - feature_flags
        - brands
        - device_types
      title: AppSettingsDocument
      type: object
    ResolutionFailure:
      properties:
        detail:
          title: Detail
          type: string
      required:
        - detail
      title: ResolutionFailure
      type: object
    AppConfig:
      properties:
        showHemsFeatureEv:
          title: Showhemsfeatureev
          type: boolean
        showHemsFeatureEvCharger:
          title: Showhemsfeatureevcharger
          type: boolean
        requireExternalUserId:
          default: false
          title: Requireexternaluserid
          type: boolean
        showHpOptimizationLevel:
          title: Showhpoptimizationlevel
          type: boolean
        showSavings:
          title: Showsavings
          type: boolean
        allowSteeringToggleHp:
          title: Allowsteeringtogglehp
          type: boolean
        allowSteeringToggleEv:
          title: Allowsteeringtoggleev
          type: boolean
        allowSteeringToggleInv:
          title: Allowsteeringtoggleinv
          type: boolean
        showSolarTab:
          title: Showsolartab
          type: boolean
        showChargingTab:
          title: Showchargingtab
          type: boolean
        showClimateTab:
          title: Showclimatetab
          type: boolean
        showExplainers:
          title: Showexplainers
          type: boolean
        showExplainersHp:
          title: Showexplainershp
          type: boolean
        showExplainersInv:
          title: Showexplainersinv
          type: boolean
      required:
        - showHemsFeatureEv
        - showHemsFeatureEvCharger
        - showHpOptimizationLevel
        - showSavings
        - allowSteeringToggleHp
        - allowSteeringToggleEv
        - allowSteeringToggleInv
        - showSolarTab
        - showChargingTab
        - showClimateTab
        - showExplainers
        - showExplainersHp
        - showExplainersInv
      title: AppConfig
      type: object
    AppFeatureFlags:
      properties:
        useAddressForm:
          title: Useaddressform
          type: boolean
        useNewTheme:
          title: Usenewtheme
          type: boolean
        enableMelcloudHome:
          title: Enablemelcloudhome
          type: boolean
      required:
        - useAddressForm
        - useNewTheme
        - enableMelcloudHome
      title: AppFeatureFlags
      type: object
    DeviceBrand:
      properties:
        id:
          title: Id
          type: string
        name:
          title: Name
          type: string
        value:
          title: Value
          type: string
        device_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Device Type
        gateway:
          title: Gateway
          type: boolean
        integration_status:
          title: Integration Status
          type: string
      required:
        - id
        - name
        - value
        - device_type
        - gateway
        - integration_status
      title: DeviceBrand
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.