---
title: "Endpoint to update the properties of the subscription."
method: PUT
path: "/webhook/management/v1/{id}"
tags: ["Endpoints"]
---

# Endpoint to update the properties of the subscription.

`PUT /webhook/management/v1/{id}`

# Update Subscription
---

The request body must contain the complete information about the subscription.

The following values can be updated: The __URL__ used for the webhook, the __event type__ applied to this URL and the __secret__, which is used to sign the payload.
It is not possible to change the identification of the subscription.

Omitting properties from the request body (e.g. secret) will result in a validation error and return the status code 400.

## Path parameters

- `id` string, required — ID of the subscription.

## Headers

- `Authorization` string, required

## Request body

- SubscriptionWihoutIdDto — Subscription element.
  - `url` Url, required — unresolved $ref
  - `event_type` EventType, required — unresolved $ref
  - `secret` Secret, required — unresolved $ref

## Response `200`

OK. The subscription was updated.

- SubscriptionDto — Subscription element.
  - `id` string — ID of the subscription.
  - `url` string, url — HTTP URL to execute the webhook call with the POST method.
  - `event_type` string — Type of the event to process by calling the API endpoint.
  - `secret` string — Parameter given by the client to sign their payloads. Recommended to be unique for each URL.

## Other responses

- `400` — Bad request due to a client error in path parameters, header or body.
- `401` — Bad request because the client cannot be authorized.
- `403` — Bad request because the client is not allowed to update the resource.
- `404` — Bad request because the resource cannot be found.
- `405` — Bad request because the HTTP method is not allowed.
- `406` — Bad request because the server cannot produce a response matching the list of acceptable values.
- `415` — Bad request because the payload format is not supported.
- `500` — An internal server error occured while processing the request.

---

[API](https://skmtc.dev/ratepay/apis/subscription-webhooks.md) · [All operations](https://skmtc.dev/ratepay/apis/subscription-webhooks/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ratepay/subscription-webhooks/revisions/5195c471cb79/schema)