---
title: "[BETA] Update an action set."
method: PUT
path: "/api/admin/projects/{projectId}/actions/{id}"
tags: ["Projects"]
---

# [BETA] Update an action set.

`PUT /api/admin/projects/{projectId}/actions/{id}`

**Enterprise feature**

**[BETA]** This API is in beta state, which means it may change or be removed in the future.

Updates an existing action set identified by its id.

## Path parameters

- `projectId` string, required
- `id` string, required

## Request body

- CreateActionsSchema — An action set defines actions that Unleash performs when a signal is matched.
  - `name` string, required — The name of the action set
  - `description` string, nullable — The description of the action set
  - `actorId` integer, required — The id of the service account that will execute the action
  - `enabled` boolean — Whether this action set is enabled or not
  - `actions` CreateActionSchema[], required — The list of actions to execute in sequential order when the action set is triggered
    - `action` string, required — The name of the action to execute
    - `sortOrder` integer, required — The order in which the action should be executed
    - `executionParams` object — A map of parameters to pass to the action
  - `match` object, required — Defines a matching rule for the signal that will trigger the action set
    - `source` 'signal-endpoint', required — Match the source of the signal
    - `sourceId` number, required — Match the source id of the signal
    - `payload` object, required — Match the payload of the signal

## Response `200`

actionsSchema

- ActionsSchema — A response model with an identifiable action set.
  - `id` integer, required — The ID of the action set.
  - `project` string, required — The project that this action set belongs to.
  - `createdAt` string, date-time, required — The date and time of when the action set was created.
  - `createdByUserId` integer, required — The ID of the user that created this action set.
  - `name` string, required — The name of the action set
  - `description` string, nullable — The description of the action set
  - `actorId` integer, required — The id of the service account that will execute the action
  - `enabled` boolean — Whether this action set is enabled or not
  - `actions` ActionSchema[], required — The list of actions to execute in sequential order when the action set is triggered.
    - `id` integer, required — The id of the action set
    - `createdAt` string, date-time, required — The date and time of when the action was created.
    - `createdByUserId` integer, required — The id of user that created this action set
    - `action` string, required — The name of the action to execute
    - `sortOrder` integer, required — The order in which the action should be executed
    - `executionParams` object — A map of parameters to pass to the action
  - `match` object, required — Defines a matching rule for the signal that will trigger the action set
    - `source` 'signal-endpoint', required — Match the source of the signal
    - `sourceId` number, required — Match the source id of the signal
    - `payload` object, required — Match the payload of the signal

## Other responses

- `400` — The request data does not match what we expect.
- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `403` — The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation
- `404` — The requested resource was not found.
- `415` — The operation does not support request payloads of the provided type. Please ensure that you're using one of the listed payload types and that you have specified the right content type in the "content-type" header.

---

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