---
title: "Update a single CustomAction"
method: PATCH
path: "/custom_actions/{id}.json"
tags: ["Custom Actions"]
---

# Update a single CustomAction

`PATCH /custom_actions/{id}.json`

Outlines the parameters and data fields used when updating a single CustomAction

## Path parameters

- `id` integer, required

## Query parameters

- `fields` string

## Headers

- `IF-MATCH` string
- `X-API-VERSION` string

## Request body

- object
  - `data` object, required
    - `label` string — Text label to be displayed on the custom link.
    - `target_url` string — Target URL which will be opened in a new tab when the user clicks the custom link.
    - `ui_reference` 'activities/show' | 'documents/show' | 'contacts/show' | 'matters/show' | 'folders/show' — UI reference location within Clio where the link will be displayed.

## Response `200`

Ok

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `429` — Too Many Requests

---

[API](https://skmtc.net/clio/apis/clio-api-documentation.md) · [All operations](https://skmtc.net/clio/apis/clio-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clio/clio-api-documentation/versions/94a82114ec3b/schema)