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

# Stations / Update

> Updates a station. Required permission: asset:stations:update. Available contexts: API Key, User.



## OpenAPI

````yaml /api/core-api/crmiapi.json put /api/v1/assets/stations/{uuid}
openapi: 3.2.0
info:
  title: chargecloud - Core API
  summary: chargecloud Core API. All around CRM, Asset Management and more.
  version: 1.141.0
  description: chargecloud Core API. All around CRM, Asset Management and more.
servers:
  - url: https://api.chargecloud.dev
    description: Production - chargecloud Core API
  - url: https://demo.chargecloud.de
    description: Sandbox/Dev - chargecloud Core API
security: []
paths:
  /api/v1/assets/stations/{uuid}:
    put:
      tags:
        - Stations
      summary: Stations / Update
      description: >-
        Updates a station. Required permission: asset:stations:update. Available
        contexts: API Key, User.
      operationId: /api/v1/assets/stations/{uuid}_PUT
      parameters:
        - name: uuid
          in: path
          description: UUID of the Station
          required: true
          schema:
            type: string
            pattern: >-
              ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
            description: UUID of the Station
        - name: Accept-Language
          in: header
          description: BCP 47 language tag for content negotiation (e.g. en, de-DE).
          required: false
          schema:
            type: string
            description: BCP 47 language tag for content negotiation (e.g. en, de-DE).
            example: en
      requestBody:
        description: >-
          Updates a station. Required permission: asset:stations:update.
          Available contexts: API Key, User.
        content:
          application/json:
            schema:
              type: object
              required:
                - controller_uuid
              properties:
                controller_uuid:
                  type: string
                  pattern: >-
                    ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                  description: >-
                    The UUID of the controller managing this station. Links the
                    station to the hardware device responsible for OCPP
                    communication with the backend.
                export:
                  type: boolean
                  default: true
                  description: >-
                    Whether the station is included in interface outputs such as
                    the Whitelabel app and POI data (e.g. Google Maps). Set to
                    false to hide it from all public-facing outputs. Defaults to
                    true.
                evse:
                  type: string
                  description: Evses of the chargepoints
                charging_technology:
                  type: string
                  enum:
                    - inductive
                    - conductive
                  description: >-
                    Charging technology. Allowed values: conductive
                    (cable-based), inductive (wireless). If it is missing or
                    null, the stored value stays unchanged.
                position:
                  type: string
                  maxLength: 100
                  description: >-
                    Physical position on the site (e.g. "Parking deck level 2,
                    bay 14").
                  example: parking bay 3
                vehicle_type:
                  type: string
                  enum:
                    - ruralenergy
                    - omnibus
                    - four_wheeled
                    - two_wheeled
                  description: >-
                    Primary vehicle category. Allowed values: ruralenergy (shore
                    power), omnibus (buses), four_wheeled (cars), two_wheeled
                    (motorcycles, e-bikes). If it is missing or null, the stored
                    value stays unchanged.
                  example: four_wheeled
                status:
                  type: string
                  enum:
                    - in_planning
                    - under_construction
                    - factory_acceptance_test
                    - demo
                    - active
                    - defect
                    - out_of_order
                    - removed
                    - undefined
                  description: >-
                    Current lifecycle state of the station. Allowed values:
                    in_planning, under_construction, factory_acceptance_test,
                    demo, active (in operation), defect, out_of_order, removed
                    (decommissioned), undefined. If it is missing or null, the
                    stored value stays unchanged.
                start_date:
                  type: string
                  format: date
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: >-
                    Planned start or project kick-off date for the station, used
                    for internal planning and project tracking.
                target_date:
                  type: string
                  format: date
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: >-
                    Target commissioning date by which the station should be
                    operational, used for installation scheduling.
                active_date:
                  type: string
                  format: date
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: >-
                    Date the station was officially put into operation. Relevant
                    for billing, reporting, and lifecycle tracking.
                out_of_order_date:
                  type: string
                  format: date
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: Date the station was taken out of order.
                ip_protection_type:
                  type: string
                  maxLength: 5
                  description: >-
                    IP rating of the enclosure (e.g. "IP54", "IP65"), indicating
                    resistance to dust and water ingress.
                particularities:
                  type: string
                  maxLength: 64
                  description: >-
                    Remarks about hardware specifics or installation
                    peculiarities.
                manufacturer:
                  type: string
                  maxLength: 100
                  description: Hardware manufacturer (e.g. ABB, Mennekes, Compleo).
                model:
                  type: string
                  maxLength: 100
                  description: Hardware model name.
                green_power:
                  type: boolean
                  default: false
                  description: >-
                    Whether the station is supplied with certified green
                    electricity. Transmitted to roaming partners and may be
                    shown in the app.
                vehicle_communication_type_id:
                  type: integer
                  format: int32
                  description: >-
                    Identifies the vehicle-to-station communication standard
                    (e.g. ISO 15118, IEC 61851), used for advanced features such
                    as Plug & Charge.
                serial_number:
                  type: integer
                  format: int32
                  description: Manufacturer-assigned serial number.
                mounting_type:
                  type: string
                  enum:
                    - ''
                    - free_standing
                    - wall
                  description: >-
                    Physical mounting style. Allowed values: free_standing
                    (pole/pillar), wall (wallbox).
                  example: wall
                sticker:
                  type: string
                  maxLength: 100
                  description: Identifier printed on the physical sticker on the station.
                color:
                  type: string
                  maxLength: 50
                  description: Colour of the enclosure (e.g. "RAL 7016 anthracite").
                automatic_rebootable_rccb:
                  type: boolean
                  default: false
                  description: >-
                    Whether the RCCB can be reset automatically by the
                    controller after a trip.
                house_connection_box:
                  type: boolean
                  default: false
                  description: >-
                    Whether the station has a dedicated house connection box
                    (Hausanschlusskasten).
                connection_cable:
                  type: string
                  maxLength: 100
                  description: >-
                    Connection cable specification (length, cross-section,
                    type).
                closing:
                  type: string
                  maxLength: 200
                  description: Lock / closing mechanism (e.g. lock cylinder code).
                  example: padlock type
                building_level:
                  type: string
                  maxLength: 20
                  description: Building floor / level (e.g. "B1", "Ground", "Level 3").
                  example: UG1
                parking_fees:
                  type: string
                  maxLength: 200
                  description: Parking fees that apply when using the station.
                crash_protection:
                  type: boolean
                  default: false
                  description: Whether crash protection (bollards, barriers) is installed.
                mark:
                  type: string
                  maxLength: 200
                  description: >-
                    Marking / labelling on the enclosure used for asset
                    tracking.
                comment:
                  type: string
                  maxLength: 500
                  description: Comment shown to operators.
                ceiling_height:
                  type: number
                  format: float
                  description: >-
                    Ceiling clearance above the station in metres. Relevant for
                    indoor installations with vehicle height restrictions.
                investment_manager:
                  type: string
                  maxLength: 64
                  description: >-
                    Person or department responsible for the capex / investment
                    side.
                project:
                  type: string
                  maxLength: 64
                  description: Name of the rollout project the station belongs to.
                order_number:
                  type: string
                  maxLength: 64
                  description: Purchase order number for the station hardware.
                notification_number:
                  type: string
                  maxLength: 64
                  description: >-
                    Reference number used for official network operator
                    notifications.
                internal_comment:
                  type: string
                  maxLength: 500
                  description: Internal comment. Not exported to public feeds.
                upstream_supply_network:
                  type: string
                  maxLength: 32
                  description: >-
                    Identifies the upstream supply network feeding the station
                    (e.g. transformer / feeder).
                protective_switching_devices:
                  type: string
                  maxLength: 64
                  description: >-
                    Protective switch devices (RCCBs, MCBs) in the supply
                    circuit.
                  example: circuit breakers
                protective_switch_devices:
                  type: string
                  maxLength: 64
                  description: >-
                    Deprecated. Use `protective_switching_devices` instead.
                    Ignored when `protective_switching_devices` is set.
                  example: circuit breakers
                full_safeguarding:
                  type: number
                  format: float
                  description: Supply protection rating in amperes (Vorsicherung).
                open_24_7:
                  type: boolean
                  default: false
                  description: >-
                    Whether the station is publicly accessible around the clock.
                    When false, specific opening hours should be configured.
                block_reservation:
                  type: boolean
                  default: false
                  description: >-
                    Whether the station is blocked from reservation outside its
                    opening hours. When true, the station cannot be reserved
                    during those periods.
                article_number:
                  type: string
                  maxLength: 16
                  description: Manufacturer / supplier article number.
                conform_with_calibration_law:
                  type: boolean
                  default: false
                  description: >-
                    Whether the station is compliant with the German calibration
                    law (Eichrecht). Required for legally compliant billing and
                    must reflect the actual hardware certification status.
                has_payment_terminal:
                  type: boolean
                  default: false
                  description: >-
                    Whether the station has an integrated payment terminal for
                    direct card or contactless payment, enabling ad-hoc payment
                    without app or RFID.
                iso_instance:
                  type: string
                  maxLength: 64
                  description: >-
                    Identifies the ISO 15118 instance configured on the station.
                    Required for Plug & Charge and vehicle-to-grid
                    communication.
                calibration_law_deadline:
                  type: string
                  format: date
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: >-
                    Expiry date of the calibration-law certification. After this
                    date the station may not be used for legally compliant
                    billing until recertified.
        required: true
      responses:
        '200':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - station
                properties:
                  station:
                    type: object
                    properties:
                      uuid:
                        type: string
                        pattern: >-
                          ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                        description: >-
                          The unique identifier of the station, automatically
                          assigned by the system upon creation. Use this UUID to
                          retrieve or reference the station in subsequent API
                          calls.
                      created_at:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Date the station was first created. Set automatically
                          and cannot be modified.
                      updated_at:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: Date of the last user-driven update.
                      modification_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Date refreshed on every persisted change to the row
                          (YYYY-MM-DD).
                      chargepoints:
                        type: array
                        items:
                          type: object
                          properties:
                            chargepoint_evse_id:
                              type: string
                              description: >-
                                EVSE ID of a charging point (e.g.
                                "DE*ABC*E12345*1").
                          required:
                            - chargepoint_evse_id
                        description: >-
                          EVSE IDs of the charging points belonging to this
                          station.
                      location_uuid:
                        type: string
                        pattern: >-
                          ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                        description: >-
                          The UUID of the location this station belongs to. A
                          station must always be assigned to exactly one
                          location and cannot be reassigned after creation.
                      controller_uuid:
                        type: string
                        pattern: >-
                          ^[a-f0-9]{8}\-[a-f0-9]{4}\-4[a-f0-9]{3}\-[89ab][a-f0-9]{3}\-[a-f0-9]{12}$
                        description: >-
                          The UUID of the controller managing this station.
                          Links the station to the hardware device responsible
                          for OCPP communication with the backend.
                      export:
                        type: boolean
                        default: true
                        description: >-
                          Whether the station is included in interface outputs
                          such as the Whitelabel app and POI data (e.g. Google
                          Maps). Set to false to hide it from all public-facing
                          outputs. Defaults to true.
                      evse:
                        type: string
                        description: Evses of the chargepoints
                      charging_technology:
                        type: string
                        enum:
                          - inductive
                          - conductive
                        description: >-
                          Charging technology. Allowed values: conductive
                          (cable-based), inductive (wireless).
                      position:
                        type: string
                        maxLength: 100
                        description: >-
                          Physical position on the site (e.g. "Parking deck
                          level 2, bay 14").
                        example: parking bay 3
                      vehicle_type:
                        type: string
                        enum:
                          - ruralenergy
                          - omnibus
                          - four_wheeled
                          - two_wheeled
                        description: >-
                          Primary vehicle category. Allowed values: ruralenergy
                          (shore power), omnibus (buses), four_wheeled (cars),
                          two_wheeled (motorcycles, e-bikes).
                        example: four_wheeled
                      status:
                        type: string
                        enum:
                          - in_planning
                          - under_construction
                          - factory_acceptance_test
                          - demo
                          - active
                          - defect
                          - out_of_order
                          - removed
                          - undefined
                        description: >-
                          Current lifecycle state of the station. Allowed
                          values: in_planning, under_construction,
                          factory_acceptance_test, demo, active (in operation),
                          defect, out_of_order, removed (decommissioned),
                          undefined.
                      start_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Planned start or project kick-off date for the
                          station, used for internal planning and project
                          tracking.
                      target_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Target commissioning date by which the station should
                          be operational, used for installation scheduling.
                      active_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Date the station was officially put into operation.
                          Relevant for billing, reporting, and lifecycle
                          tracking.
                      out_of_order_date:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: Date the station was taken out of order.
                      ip_protection_type:
                        type: string
                        maxLength: 5
                        description: >-
                          IP rating of the enclosure (e.g. "IP54", "IP65"),
                          indicating resistance to dust and water ingress.
                      particularities:
                        type: string
                        maxLength: 64
                        description: >-
                          Remarks about hardware specifics or installation
                          peculiarities.
                      manufacturer:
                        type: string
                        maxLength: 100
                        description: Hardware manufacturer (e.g. ABB, Mennekes, Compleo).
                      model:
                        type: string
                        maxLength: 100
                        description: Hardware model name.
                      green_power:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is supplied with certified green
                          electricity. Transmitted to roaming partners and may
                          be shown in the app.
                      vehicle_communication_type_id:
                        type: integer
                        format: int32
                        description: >-
                          Identifies the vehicle-to-station communication
                          standard (e.g. ISO 15118, IEC 61851), used for
                          advanced features such as Plug & Charge.
                      serial_number:
                        type: integer
                        format: int32
                        description: Manufacturer-assigned serial number.
                      mounting_type:
                        type: string
                        enum:
                          - ''
                          - free_standing
                          - wall
                        description: >-
                          Physical mounting style. Allowed values: free_standing
                          (pole/pillar), wall (wallbox).
                        example: wall
                      sticker:
                        type: string
                        maxLength: 100
                        description: >-
                          Identifier printed on the physical sticker on the
                          station.
                      color:
                        type: string
                        maxLength: 50
                        description: Colour of the enclosure (e.g. "RAL 7016 anthracite").
                      automatic_rebootable_rccb:
                        type: boolean
                        default: false
                        description: >-
                          Whether the RCCB can be reset automatically by the
                          controller after a trip.
                      house_connection_box:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station has a dedicated house connection
                          box (Hausanschlusskasten).
                      connection_cable:
                        type: string
                        maxLength: 100
                        description: >-
                          Connection cable specification (length, cross-section,
                          type).
                      closing:
                        type: string
                        maxLength: 200
                        description: Lock / closing mechanism (e.g. lock cylinder code).
                        example: padlock type
                      building_level:
                        type: string
                        maxLength: 20
                        description: >-
                          Building floor / level (e.g. "B1", "Ground", "Level
                          3").
                        example: UG1
                      parking_fees:
                        type: string
                        maxLength: 200
                        description: Parking fees that apply when using the station.
                      crash_protection:
                        type: boolean
                        default: false
                        description: >-
                          Whether crash protection (bollards, barriers) is
                          installed.
                      mark:
                        type: string
                        maxLength: 200
                        description: >-
                          Marking / labelling on the enclosure used for asset
                          tracking.
                      comment:
                        type: string
                        maxLength: 500
                        description: Comment shown to operators.
                      ceiling_height:
                        type: number
                        format: float
                        description: >-
                          Ceiling clearance above the station in metres.
                          Relevant for indoor installations with vehicle height
                          restrictions.
                      investment_manager:
                        type: string
                        maxLength: 64
                        description: >-
                          Person or department responsible for the capex /
                          investment side.
                      project:
                        type: string
                        maxLength: 64
                        description: Name of the rollout project the station belongs to.
                      order_number:
                        type: string
                        maxLength: 64
                        description: Purchase order number for the station hardware.
                      notification_number:
                        type: string
                        maxLength: 64
                        description: >-
                          Reference number used for official network operator
                          notifications.
                      internal_comment:
                        type: string
                        maxLength: 500
                        description: Internal comment. Not exported to public feeds.
                      upstream_supply_network:
                        type: string
                        maxLength: 32
                        description: >-
                          Identifies the upstream supply network feeding the
                          station (e.g. transformer / feeder).
                      protective_switching_devices:
                        type: string
                        maxLength: 64
                        description: >-
                          Protective switch devices (RCCBs, MCBs) in the supply
                          circuit.
                        example: circuit breakers
                      full_safeguarding:
                        type: number
                        format: float
                        description: Supply protection rating in amperes (Vorsicherung).
                      open_24_7:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is publicly accessible around the
                          clock. When false, specific opening hours should be
                          configured.
                      block_reservation:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is blocked from reservation
                          outside its opening hours. When true, the station
                          cannot be reserved during those periods.
                      article_number:
                        type: string
                        maxLength: 16
                        description: Manufacturer / supplier article number.
                      conform_with_calibration_law:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station is compliant with the German
                          calibration law (Eichrecht). Required for legally
                          compliant billing and must reflect the actual hardware
                          certification status.
                      has_payment_terminal:
                        type: boolean
                        default: false
                        description: >-
                          Whether the station has an integrated payment terminal
                          for direct card or contactless payment, enabling
                          ad-hoc payment without app or RFID.
                      iso_instance:
                        type: string
                        maxLength: 64
                        description: >-
                          Identifies the ISO 15118 instance configured on the
                          station. Required for Plug & Charge and
                          vehicle-to-grid communication.
                      calibration_law_deadline:
                        type: string
                        format: date
                        pattern: ^\d{4}-\d{2}-\d{2}$
                        description: >-
                          Expiry date of the calibration-law certification.
                          After this date the station may not be used for
                          legally compliant billing until recertified.
                    required:
                      - uuid
                      - created_at
                      - updated_at
                      - modification_date
                      - chargepoints
                      - location_uuid
                      - controller_uuid
                    description: >-
                      The charging station record with its charge points,
                      location, controller and hardware data.
          description: The updated charging station.
        '401':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Unauthorized
        '403':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Forbidden
        '404':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Not found
        '405':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Method not allowed
        '422':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - errors
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        errorKey:
                          type: string
                          description: A key identifying the error
                        message:
                          type: string
                          description: The error message
                        parameter:
                          type: string
                          description: The parameter that caused the error, if any
                      required:
                        - errorKey
                        - message
                        - parameter
                      description: Error
                    description: List of errors
          description: Request validation failed
        '500':
          headers:
            Content-Language:
              description: The locale of the response content (BCP 47 language tag).
              required: false
              schema:
                type: string
                example: en
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
                    description: Error message
          description: Internal server error
      security:
        - bearer:
            - asset:stations
components:
  securitySchemes:
    bearer:
      type: http
      description: OAuth2 Bearer Authorization
      scheme: bearer
      bearerFormat: JWT

````

## Related topics

- [Meters / Update](https://chargecloud.dev/api-reference/meters/meters-update.md)
- [Parking / Update](https://chargecloud.dev/api-reference/parking/parking-update.md)
- [Stations / Read](https://chargecloud.dev/api-reference/stations/stations-read.md)


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