---
title: "Subscribe to PowerBank"
method: PATCH
path: "/api/v1/teams/{teamId}/grid"
tags: ["Teams"]
---

# Subscribe to PowerBank

`PATCH /api/v1/teams/{teamId}/grid`

Subscribes every charge point in the team to PowerBank, auto-selecting the best available grid provider. Returns the per-charge-point subscription result, including any per-charge-point failures. Required scope: `charge-points:write` </br>Organization authorization: `supported`

## Path parameters

- `teamId` integer, required

## Response `200`

Per-charge-point subscribe result

- TeamGridBulkResult
  - `succeeded` ChargePointGridV2Response[], required
    - `name` string, required
    - `subscription` GridSubscriptionV2, required
      - `status` 'UNKNOWN' | 'OPEN' | 'BETA' | 'OPEN_BETA' | 'OPEN_FOR_REGISTER' | 'REGISTER_ONLY' | 'SUBSCRIBED' | 'SUBSCRIBED_BETA' | 'SUBSCRIBED_REGISTER' | 'CLOSED' | 'CLOSED_BETA' | 'MISSING_METER_ID', required
      - `gridPartner` string, nullable
      - `title` string, required
      - `description` string, required
      - `statusReason` string, nullable
      - `teaser` string, nullable
      - `terms` string, nullable
      - `termsAgreement` string, nullable
      - `smartMeterConsentTitle` string, nullable
      - `smartMeterConsentText` string, nullable
      - `smartMeterConsentAgreement` string, nullable
      - `statusLabel` string, nullable
    - `meterId` GridServiceProviderMeterId
      - `id` string, nullable
      - `status` 'MANDATORY' | 'NOT_REQUIRED' | 'OPTIONAL', required
      - `label` string, required
      - `title` string, nullable
      - `subtitle` string, nullable
      - `description` string, nullable
      - `formatRegex` string, nullable
      - `formatDescription` string, nullable
      - `formatHint` string, nullable
      - `requiredLabel` string, nullable
      - `invalidFormatLabel` string, nullable
    - `infoUrl` string, nullable
    - `activeAt` string, date-time, nullable
    - `participationReport` ParticipationHistoryReport
      - `subtitle` string, required
      - `currency` CurrencyDto1, required
        - `id` integer, required
        - `identifier` string, required
        - `name` string, required
        - `decimals` integer, required
        - `name_localized` object, required
      - `records` ParticipationHistoryRecord[], nullable
        - `id` integer, required
        - `start_time` string, date-time, required
        - `kwh` number, double, required
        - `payout` number, double, required
        - `payout_label` string, required
      - `messages` ParticipationHistoryMessage[], nullable
        - `id` integer, required
        - `title` string, required
        - `body` string, required
        - `button_text` string, required
        - `start_time` string, date-time, required
        - `end_time` string, date-time, required
      - `registered_only_reason` string, nullable
      - `info_url` string, nullable
      - `total_kwh` number, double, required
      - `total_payout` number, double, required
      - `total_kwh_label` string, required
      - `total_payout_label` string, required
    - `feedbackMessages` GridServiceProviderFeedbackMessages
      - `configurationSaved` string, required
      - `meterIdUpdated` string, required
      - `subscribeSuccess` string, required
      - `unsubscribeSuccess` string, required
  - `failed` TeamGridBulkFailure[], required
    - `chargePointId` integer, required
    - `errorCode` string, required
    - `message` string, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

[API](https://skmtc.net/monta/apis/monta-partner-api.md) · [All operations](https://skmtc.net/monta/apis/monta-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monta/monta-partner-api/versions/517e18f11015/schema)
