---
title: "Update Benefit Grant"
method: PATCH
path: "/v1/customer-portal/benefit-grants/{id}"
tags: ["customer_portal", "benefit-grants", "public"]
---

# Update Benefit Grant

`PATCH /v1/customer-portal/benefit-grants/{id}`

Update a benefit grant for the authenticated customer.

**Scopes**: `customer_portal:write`

## Path parameters

- `id` string, uuid4, required — The benefit grant ID.

## Request body

- union
  - CustomerBenefitGrantDiscordUpdate
    - `benefit_type` 'discord', required
    - `properties` CustomerBenefitGrantDiscordPropertiesUpdate, required
      - `account_id` string, nullable, required
  - CustomerBenefitGrantGitHubRepositoryUpdate
    - `benefit_type` 'github_repository', required
    - `properties` CustomerBenefitGrantGitHubRepositoryPropertiesUpdate, required
      - `account_id` string, nullable, required
  - CustomerBenefitGrantDownloadablesUpdate
    - `benefit_type` 'downloadables', required
  - CustomerBenefitGrantLicenseKeysUpdate
    - `benefit_type` 'license_keys', required
  - CustomerBenefitGrantCustomUpdate
    - `benefit_type` 'custom', required
  - CustomerBenefitGrantMeterCreditUpdate
    - `benefit_type` 'meter_credit', required
  - CustomerBenefitGrantFeatureFlagUpdate
    - `benefit_type` 'feature_flag', required
  - CustomerBenefitGrantSlackSharedChannelUpdate
    - `benefit_type` 'slack_shared_channel', required
    - `properties` CustomerBenefitGrantSlackSharedChannelPropertiesUpdate, required
      - `invited_email` string, email, required

## Response `200`

Benefit grant updated.

- union
  - CustomerBenefitGrantDiscord — unresolved $ref
  - CustomerBenefitGrantGitHubRepository — unresolved $ref
  - CustomerBenefitGrantDownloadables — unresolved $ref
  - CustomerBenefitGrantLicenseKeys — unresolved $ref
  - CustomerBenefitGrantCustom — unresolved $ref
  - CustomerBenefitGrantMeterCredit — unresolved $ref
  - CustomerBenefitGrantFeatureFlag — unresolved $ref
  - CustomerBenefitGrantSlackSharedChannel — unresolved $ref

## Other responses

- `403` — The benefit grant is revoked and cannot be updated.
- `404` — Benefit grant not found.
- `422` — Validation Error

---

[API](https://skmtc.net/polar/apis/polar-api.md) · [All operations](https://skmtc.net/polar/apis/polar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polar/polar-api/revisions/1ee4b8be5abd/schema)
