[BETA] Create an action set. | Unleash Documentation

curl -X POST https://app.unleash-instance.example.com/api/admin/projects/projectId/actions \
     -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.

Creates a new action set.

curl -X POST https://app.unleash-instance.example.com/api/admin/projects/projectId/actions \
     -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.

Creates a new action set.

Authentication

Authorizationstring

API key needed to access this API

AuthorizationBearer

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

Path parameters

projectIdstringRequired

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 headers

locationstring

The location of the newly created resource.

Response

The resource was successfully created.

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

409

Conflict Error

415

Unsupported Media Type Error

$	curl -X POST https://app.unleash-instance.example.com/api/admin/projects/projectId/actions \
>	-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	}