[BETA] Update an action set. | Unleash Documentation

curl -X PUT https://app.unleash-instance.example.com/api/admin/projects/projectId/actions/id \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Disable new features",
  "actorId": 12,
  "actions": [
    {
      "action": "disable-feature",
      "sortOrder": 1
    }
  ],
  "match": {
    "source": "signal-endpoint",
    "sourceId": 123,
    "payload": {
      "type": "error-rate-above-threshold"
    }
  }
}'

{
  "id": 1,
  "project": "default",
  "createdAt": "2023-12-27T13:37:00+01:00",
  "createdByUserId": 1,
  "name": "Disable new features",
  "actorId": 12,
  "actions": [
    {
      "id": 1,
      "createdAt": "2023-12-27T13:37:00+01:00",
      "createdByUserId": 1,
      "action": "disable-feature",
      "sortOrder": 1,
      "executionParams": {
        "featureName": "my-feature"
      }
    }
  ],
  "match": {
    "source": "signal-endpoint",
    "sourceId": 123,
    "payload": {
      "type": "error-rate-above-threshold"
    }
  },
  "description": "Disables new features when error rate is above threshold",
  "enabled": true
}

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.

curl -X PUT https://app.unleash-instance.example.com/api/admin/projects/projectId/actions/id \
     -H "Authorization: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Disable new features",
  "actorId": 12,
  "actions": [
    {
      "action": "disable-feature",
      "sortOrder": 1
    }
  ],
  "match": {
    "source": "signal-endpoint",
    "sourceId": 123,
    "payload": {
      "type": "error-rate-above-threshold"
    }
  }
}'

{
  "id": 1,
  "project": "default",
  "createdAt": "2023-12-27T13:37:00+01:00",
  "createdByUserId": 1,
  "name": "Disable new features",
  "actorId": 12,
  "actions": [
    {
      "id": 1,
      "createdAt": "2023-12-27T13:37:00+01:00",
      "createdByUserId": 1,
      "action": "disable-feature",
      "sortOrder": 1,
      "executionParams": {
        "featureName": "my-feature"
      }
    }
  ],
  "match": {
    "source": "signal-endpoint",
    "sourceId": 123,
    "payload": {
      "type": "error-rate-above-threshold"
    }
  },
  "description": "Disables new features when error rate is above threshold",
  "enabled": true
}

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.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

API key needed to access this API, in Bearer token format

Path parameters

projectIdstringRequired

idstringRequired

Request

createActionsSchema

namestringRequired

The name of the action set

actorIdintegerRequired>=1

The id of the service account that will execute the action

actionslist of objectsRequired

The list of actions to execute in sequential order when the action set is triggered

matchobjectRequired

Defines a matching rule for the signal that will trigger the action set

descriptionstring or nullOptional

The description of the action set

enabledbooleanOptionalDefaults to true

Whether this action set is enabled or not

Response

actionsSchema

idinteger>=1

The ID of the action set.

projectstring

The project that this action set belongs to.

createdAtstringformat: "date-time"

The date and time of when the action set was created.

createdByUserIdinteger

The ID of the user that created this action set.

namestring

The name of the action set

actorIdinteger>=1

The id of the service account that will execute the action

actionslist of objects

The list of actions to execute in sequential order when the action set is triggered.

matchobject

Defines a matching rule for the signal that will trigger the action set

descriptionstring or null

The description of the action set

enabledbooleanDefaults to true

Whether this action set is enabled or not

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

415

Unsupported Media Type Error

$	curl -X PUT https://app.unleash-instance.example.com/api/admin/projects/projectId/actions/id \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Disable new features",
>	"actorId": 12,
>	"actions": [
>	{
>	"action": "disable-feature",
>	"sortOrder": 1
>	}
>	],
>	"match": {
>	"source": "signal-endpoint",
>	"sourceId": 123,
>	"payload": {
>	"type": "error-rate-above-threshold"
>	}
>	}
>	}'

1	{
2	"id": 1,
3	"project": "default",
4	"createdAt": "2023-12-27T13:37:00+01:00",
5	"createdByUserId": 1,
6	"name": "Disable new features",
7	"actorId": 12,
8	"actions": [
9	{
10	"id": 1,
11	"createdAt": "2023-12-27T13:37:00+01:00",
12	"createdByUserId": 1,
13	"action": "disable-feature",
14	"sortOrder": 1,
15	"executionParams": {
16	"featureName": "my-feature"
17	}
18	}
19	],
20	"match": {
21	"source": "signal-endpoint",
22	"sourceId": 123,
23	"payload": {
24	"type": "error-rate-above-threshold"
25	}
26	},
27	"description": "Disables new features when error rate is above threshold",
28	"enabled": true
29	}