---
title: "Update action by action key"
type: reference
method: POST
path: /rest-api/action/{key}/update.do
tag: "Actions"
---

# Update action by action key

`POST https://YOUR-NETWORK-DOMAIN/rest-api/action/{key}/update.do`

Updates an existing conversion action identified by its unique action key. Only provided (non-null) request parameters are applied as a partial update -- omitted fields retain their current values. You can update the action name, click-to-conversion time frame/period, and view-to-conversion time frame/period. Returns 404 if no action exists with the given key. The update is logged to the action log. Requires authentication.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `key` | string | yes | `a1b2c3d4e5` | The unique action key string identifying the action to update. |

## Form params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `name` | string | no | `Purchase` | New display name for the action, up to 64 characters and not blank. If omitted, the existing name is preserved. |
| `clickToConversionTimeFrame` | integer | no | `7` | Click-to-conversion attribution window duration, 0 to 255 units. Defines how long after a click a conversion can be attributed to the ad. |
| `clickToConversionTimeFramePeriodType` | string | no | `DAY` | Time unit for clickToConversionTimeFrame. Allowed values: SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR. |
| `viewToConversionTimeFrame` | integer | no | `1` | View-to-conversion attribution window duration, 0 to 255 units. Defines how long after an ad view/impression a conversion can be attributed. |
| `viewToConversionTimeFramePeriodType` | string | no | `DAY` | Time unit for viewToConversionTimeFrame. Allowed values: SECOND, MINUTE, HOUR, DAY, WEEK, MONTH, YEAR. |
| `applyAttributionWindowToServerToServer` | boolean | no | `true` | Whether the attribution window is also applied to server-to-server conversions. Server-to-server postbacks carry no impression or click identity of their own, so this is off for actions created before the option existed and on for new ones. Omit to keep the current value. |
| `rejectDuplicateConversions` | boolean | no | `false` | Whether a repeat of the same event on one click is thrown away. Off by default: repeats count. Applies to both server-to-server postbacks and the cookie pixel. A tracking-event action repeats by definition and is exempt regardless. |
| `defaultAttributionType` | string | no | `POST_CLICK` | Attribution type applied to a conversion that arrives with no attribution of its own — the last resort, below the action's tracking event, the partner's att= parameter and the classification carried by the tracking token. Allowed values: UNSPECIFIED, POST_CLICK, POST_VIEW (or integer IDs 0, 1, 2). Omit to keep the current value. |

## Responses

- `200` — The updated action, in the shape the action GET returns
- `400` — Bad request — wrong parameter types
- `401` — Authentication error
- `403` — Not enough permissions
- `404` — No action found with the given action key

## Example request

```bash
curl --request POST \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/action/a1b2c3d4e5/update.do' \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'name=Purchase' \
  --data-urlencode 'clickToConversionTimeFrame=7' \
  --data-urlencode 'clickToConversionTimeFramePeriodType=DAY'
```

Source: https://epom.com/ad-server/docs/api/actions/post-action-update