> ## 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.

# Trigger a boost charge or arm boost for the next session

> Trigger a "charge now" boost on the wallbox, overriding HEMS surplus control.

Behaviour depends on the wallbox's current state:

- **Plugged in + idle** (`boost_state=available`, e.g. HEMS paused at 0 A):
  immediately holds the box at full rate, bypassing the surplus gates.
- **Unplugged** (`boost_state=unavailable`): arms `boost_for_next_session=True`;
  the next plug-in's workflow auto-fires boost, then clears the flag.
- **Already charging / in flight** (`ongoing` or `requested`): 409 with
  `reason=already_charging`.
- **Fully charged**: 409 with `reason=fully_charged`.

Returns 204 on success (boost triggered or armed). Returns 409 when the request
can't be honoured, with `state` (current `boost_state`) and `reason`
(`already_charging`, `fully_charged`, or `internal_error`). The arm path is
idempotent. To cancel a live boost or clear an armed flag, use `DELETE /boost`.



## OpenAPI

````yaml https://app.podero.com/api/partners/v2.0/openapi.json post /api/partners/v2.0/org/{org_id}/users/{user_id}/wallboxes/{wallbox_id}/boost
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.
  termsOfService: https://www.podero.com/terms-and-conditions
servers: []
security: []
paths:
  /api/partners/v2.0/org/{org_id}/users/{user_id}/wallboxes/{wallbox_id}/boost:
    post:
      tags:
        - User Wallboxes
      summary: Trigger a boost charge or arm boost for the next session
      description: >-
        Trigger a "charge now" boost on the wallbox, overriding HEMS surplus
        control.


        Behaviour depends on the wallbox's current state:


        - **Plugged in + idle** (`boost_state=available`, e.g. HEMS paused at 0
        A):
          immediately holds the box at full rate, bypassing the surplus gates.
        - **Unplugged** (`boost_state=unavailable`): arms
        `boost_for_next_session=True`;
          the next plug-in's workflow auto-fires boost, then clears the flag.
        - **Already charging / in flight** (`ongoing` or `requested`): 409 with
          `reason=already_charging`.
        - **Fully charged**: 409 with `reason=fully_charged`.


        Returns 204 on success (boost triggered or armed). Returns 409 when the
        request

        can't be honoured, with `state` (current `boost_state`) and `reason`

        (`already_charging`, `fully_charged`, or `internal_error`). The arm path
        is

        idempotent. To cancel a live boost or clear an armed flag, use `DELETE
        /boost`.
      operationId: >-
        integrations_api_api_v2_organizations_users_wallboxes_router_trigger_wb_boost_endpoint
      parameters:
        - in: path
          name: org_id
          schema:
            description: The organization ID
            format: uuid
            title: Org Id
            type: string
          required: true
          description: The organization ID
        - in: path
          name: user_id
          schema:
            description: The user ID whom the wallbox belongs to
            format: uuid
            title: User Id
            type: string
          required: true
          description: The user ID whom the wallbox belongs to
        - in: path
          name: wallbox_id
          schema:
            description: The EV charger (wallbox) UUID
            format: uuid
            title: Wallbox Id
            type: string
          required: true
          description: The EV charger (wallbox) UUID
      responses:
        '204':
          description: No Content
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                additionalProperties: true
                title: Response
                type: object
      security:
        - OAuth2: []
components:
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}
        clientCredentials:
          tokenUrl: /api/partners/v2.0/auth/token
          scopes: {}

````