---
title: "Update subscription for an event"
method: PATCH
path: "/v1/notifications/configurations/{eventId}/subscriptions/{subscriptionId}"
tags: ["Notifications"]
---

# Update subscription for an event

`PATCH /v1/notifications/configurations/{eventId}/subscriptions/{subscriptionId}`

Update subscription for an event.

## Request body

- EventSubscription — Properties associated with an event subscription.
  - `regions` NotificationRegion[], required
  - `entities` string[], required
  - `channels` NotificationChannel[], required
    - `type` 'EMAIL' | 'IN_APP', required
    - `enabled` boolean, required
  - `enabled` boolean, required — Enable/Disable complete subscription within an event.
  - `name` string, required — User provided name of the subscription.

## Response `200`

Response containing specific subscription details associated with an event.

- EventSubscriptionResponse — Properties associated with an event subscription.
  - `id` string, uuid, required — Contains a unique identifier used for this resource.
  - `entity_type` 'billing-invoice' | 'access-token' | 'webhook' | 'dev-portal' | 'dataplane-group' | 'dataplane' | 'kai-enablement' | 'enterprise-trial', required
  - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
  - `regions` NotificationRegion[], required
  - `entities` string[], required
  - `channels` NotificationChannel[], required
    - `type` 'EMAIL' | 'IN_APP', required
    - `enabled` boolean, required
  - `enabled` boolean, required — Enable/Disable complete subscription within an event.
  - `name` string, required — User provided name of the subscription.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-04-17** `c80d57ed14ab` — 1 warning
  - added the new `enterprise-trial` enum value to the `entity_type` response property for the response status `200`
- **2026-01-29** `48b406d912db` — 1 warning
  - added the new `kai-enablement` enum value to the `entity_type` response property for the response status `200`
- **2025-10-23** `8ab3ec3ed301` — 1 warning
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
- **2025-08-22** `3c0154b2053a` — 9 breaking
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - …5 more
- …earlier changes not shown

[Full history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/notifications/configurations/:eventId/subscriptions/:subscriptionId/patch.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/7d3c634668f8/schema)