---
title: "Updates a handler."
method: PATCH
path: "/handlers/{id}"
tags: ["handlers"]
---

# Updates a handler.

`PATCH /handlers/{id}`

Updates an existing handler.

## Path parameters

- `id` string, required

## Request body

- HandlerConfiguration — The configurable properties of a handler.
  - `description` string — Describes the functionality provided by the handler.
  - `file` string — Endpoint reference to a particular version of a file.
  - `function` object
    - `name` string, required — The handler function's name.
    - `type` 'handle-request' | 'handle-response' | 'compute', required — The handler function's type. One of 'handle-request', 'handle-response' or 'compute'
    - `runtime` 'nodejs14' | 'nodejs16' — The version of the runtime in which the handler function runs.
  - `memory` integer — The amount of memory, in MB, allocated to the handler during execution.
  - `service` string — The service into which the handler will publish resources.

## Response `200`

The handler was successfully updated.

- Handler — The properties of a handler that are updated automatically as it modified.
  - `name` string — The name of the handler.
  - `account` string — A reference to an account
  - `href` string — A reference to the handler.
  - `description` string — Describes the functionality provided by the handler.
  - `file` string — Endpoint reference to a particular version of a file.
  - `function` object
    - `name` string, required — The handler function's name.
    - `type` 'handle-request' | 'handle-response' | 'compute', required — The handler function's type. One of 'handle-request', 'handle-response' or 'compute'
    - `runtime` 'nodejs14' | 'nodejs16' — The version of the runtime in which the handler function runs.
  - `memory` integer — The amount of memory, in MB, allocated to the handler during execution.
  - `service` string — The service into which the handler will publish resources.
  - `associations` CdnControlAssociation[] — The applications and CDN control paths with which the handler is associated.
    - `application` string — The endpoint for the application resource.
    - `cdn_controls` CdnControlPath[]
  - `created` string, date-time — The time when the handler was created.
  - `updated` string, date-time — The time when the handler was last updated.
  - `xref` string — A reference to the provider resource implementing the handler.

---

[API](https://skmtc.dev/webscale/apis/webscale-apis.md) · [All operations](https://skmtc.dev/webscale/apis/webscale-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webscale/webscale-apis/revisions/c98d872b50cb/schema)