# Modify actions for a line item

Modifies the list of actions for a line item. The existing actions can be re-ordered, modified or omitted, and new actions can be added to the list. If an action is omitted, it will be completely removed and the current counts for a related allocation will be lost; therefore, care should be taken when making any changes.

Endpoint: PUT /v1.0/instances/{instanceId}/line-items/{lineItemId}/actions
Version: 1.0
Security: AdministrationAccess, ClientAccess

## Path parameters:

  - `instanceId` (string, required)
    The UUID of the Dynamic Monetization instance.

  - `lineItemId` (string, required)
    Line item ID. 
Note: This is also known as the activation ID.

## Request fields (application/json):

  - `id` (string)
    A generated identifier to uniquely identify the action.

  - `name` (string)
    A human readable name to help a user identify the action. The same name may be re-used in other line items.

  - `conditionId` (string)
    The unique identifier of the condition that triggers this action.

Required, unless defining a default action. Only one default action may be defined per line item.

  - `action` (string, required)
    The action to take when the condition is met.
    Enum: "ALLOW", "DENY"

  - `allocation` (number)
    The maximum number of tokens that may be consumed from the stated line item by requests satisfying the condition.

Required for ALLOW, but may be omitted at most once per line item to create a default ALLOW action.
Not used for DENY.
    Example: 1000

## Response 200 fields (application/json):

  - `id` (string)
    A generated identifier to uniquely identify the action.

  - `name` (string)
    A human readable name to help a user identify the action. The same name may be re-used in other line items.

  - `conditionId` (string)
    The unique identifier of the condition that triggers this action.

Required, unless defining a default action. Only one default action may be defined per line item.

  - `action` (string, required)
    The action to take when the condition is met.
    Enum: "ALLOW", "DENY"

  - `allocation` (number)
    The maximum number of tokens that may be consumed from the stated line item by requests satisfying the condition.

Required for ALLOW, but may be omitted at most once per line item to create a default ALLOW action.
Not used for DENY.
    Example: 1000

  - `used` (number)
    The total count that has been consumed from the allocation by access requests.

This field is only present for actions which have an allocation.