---
title: "Update share"
method: POST
path: "/energy-communities/{energyCommunityId}/update-share"
tags: ["Energy communities"]
---

# Update share

`POST /energy-communities/{energyCommunityId}/update-share`

## Request

- Base URL: `https://connect.clever.gy`
- URL: `https://connect.clever.gy/energy-communities/{energyCommunityId}/update-share`
- Auth: API key in header `clevergy-api-key`

Update share for an energy community house

## Path parameters

- `energyCommunityId` string, required

## Request body

- UpdateEnergyCommunityHouseRequest: Update energy community house share
  - `houseId` string, required: House Id
  - `share` number, required: Share (in percentage) in the energy community
  - `installationId` string: Installation Id

## Response `200`

House successfully updated

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Resource not found
- `default`: Unexpected error

---

[API](https://skmtc.dev/clevergy/apis/clevergy-connect-api.md) - [All operations](https://skmtc.dev/clevergy/apis/clevergy-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clevergy/apis/clevergy-connect-api/revisions/d333c5eecb5b?raw)