---
title: "Update a custom action"
method: PATCH
path: "/v1/custom_actions/{context}/{action_id}/"
---

# Update a custom action

`PATCH /v1/custom_actions/{context}/{action_id}/`

## Request

- Base URL: `https://app.iconik.io/API/assets`
- URL: `https://app.iconik.io/API/assets/v1/custom_actions/{context}/{action_id}/`
- Auth: none declared. Required headers: `App-ID`, `Auth-Token`
- TypeScript: <https://skmtc.dev/iconik/apis/iconik-assets/docs/v1/custom_actions/:context/:action_id/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `context` string, required
- `action_id` string, required

## Headers

- `App-ID` string, required
- `Auth-Token` string, required

## Request body

- CustomActionSchema
  - `app_id` string, uuid, nullable
  - `color` string, nullable
  - `context` 'ASSET' | 'ASSET_SUBCLIP' | 'SHARED_ASSET' | 'COLLECTION' | 'SHARED_COLLECTION' | 'BULK' | 'SAVED_SEARCH' | 'NONE' | 'PLAYLIST' | 'SHARED_PLAYLIST', required
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `disabled` boolean
  - `headers` object
  - `id` string, uuid
  - `last_error` string
  - `last_error_date` string, date-time
  - `metadata_view` string, uuid, nullable
  - `publish_template_id` string, nullable
  - `status` 'FAILING' | 'HEALTHY'
  - `system_domain_id` string, uuid
  - `title` string, required
  - `transcoder_id` string, uuid, nullable
  - `type` 'OPEN' | 'POST' | 'PUBLISH'
  - `url` string, required

## Response `200`

Returns an updated custom action

- CustomActionSchema
  - `app_id` string, uuid, nullable
  - `color` string, nullable
  - `context` 'ASSET' | 'ASSET_SUBCLIP' | 'SHARED_ASSET' | 'COLLECTION' | 'SHARED_COLLECTION' | 'BULK' | 'SAVED_SEARCH' | 'NONE' | 'PLAYLIST' | 'SHARED_PLAYLIST', required
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `disabled` boolean
  - `headers` object
  - `id` string, uuid
  - `last_error` string
  - `last_error_date` string, date-time
  - `metadata_view` string, uuid, nullable
  - `publish_template_id` string, nullable
  - `status` 'FAILING' | 'HEALTHY'
  - `system_domain_id` string, uuid
  - `title` string, required
  - `transcoder_id` string, uuid, nullable
  - `type` 'OPEN' | 'POST' | 'PUBLISH'
  - `url` string, required

## Other responses

- `400`: Bad request
- `401`: Token is invalid
- `403`: Permission denied
- `404`: Custom action does not exist
- `default`: Error response

---

[API](https://skmtc.dev/iconik/apis/iconik-assets.md) - [All operations](https://skmtc.dev/iconik/apis/iconik-assets/llms.txt) - [OpenAPI document](https://skmtc.dev/iconik/apis/iconik-assets/revisions/62580d9e640e?raw)