# Action Updates

## List all action updates

> Returns a list of action updates (a changelog of modifications) for the campaign.\
> Action updates are returned by creation date, with the most recently created updates appearing first.\
> \
> The recommended approach is to filter by \`StartDate\` and \`EndDate\` to retrieve updates within a specific range.<br>

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Actions","version":"v11"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"ActionUpdate":{"type":"object","description":"Represents a single modification event in an action's lifecycle. Acts as a changelog entry.","properties":{"Id":{"type":"string","description":"Unique identifier for this action update record."},"ActionId":{"type":"string","description":"Unique identifier for the parent action that was updated."},"State":{"type":"string","description":"The state of the action at the time of this update.","enum":["PENDING","APPROVED","REVERSED"]},"DeltaPayout":{"type":"number","description":"The change in the Payout value recorded by this update."},"DeltaAmount":{"type":"number","description":"The change in the Amount (sale amount) value recorded by this update."},"UpdateDate":{"type":"string","format":"date-time","description":"Timestamp of when this update was recorded."},"Uri":{"type":"string","description":"Unique URI reference to this action update object."}}}}},"paths":{"/Advertisers/{AccountSID}/ActionUpdates":{"get":{"operationId":"listActionUpdates","tags":["Action Updates"],"summary":"List all action updates","description":"Returns a list of action updates (a changelog of modifications) for the campaign.\nAction updates are returned by creation date, with the most recently created updates appearing first.\n\nThe recommended approach is to filter by `StartDate` and `EndDate` to retrieve updates within a specific range.\n","parameters":[{"name":"AccountSID","in":"path","required":true,"description":"Your unique account identifier.","schema":{"type":"string"}},{"name":"CampaignId","in":"query","required":true,"description":"The ID of the campaign to list action updates for.","schema":{"type":"integer"}},{"name":"StartDate","in":"query","description":"Filters for updates with an UpdateDate on or after this value (ISO 8601 with time component).\nMust be used together with EndDate. Cannot be more than 3 years in the past, and the range cannot exceed 45 days.\n","schema":{"type":"string","format":"date-time"}},{"name":"EndDate","in":"query","description":"Filters for updates with an UpdateDate on or before this value (ISO 8601 with time component).\nMust be used together with StartDate.\n","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"An array of action update objects.","content":{"application/json":{"schema":{"type":"object","properties":{"ActionUpdates":{"type":"array","items":{"$ref":"#/components/schemas/ActionUpdate"}}}}}}}}}}}}
```

## Retrieve an action update

> Retrieves the details for a specific update record using its unique ActionUpdateId.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Actions","version":"v11"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}},"schemas":{"ActionUpdate":{"type":"object","description":"Represents a single modification event in an action's lifecycle. Acts as a changelog entry.","properties":{"Id":{"type":"string","description":"Unique identifier for this action update record."},"ActionId":{"type":"string","description":"Unique identifier for the parent action that was updated."},"State":{"type":"string","description":"The state of the action at the time of this update.","enum":["PENDING","APPROVED","REVERSED"]},"DeltaPayout":{"type":"number","description":"The change in the Payout value recorded by this update."},"DeltaAmount":{"type":"number","description":"The change in the Amount (sale amount) value recorded by this update."},"UpdateDate":{"type":"string","format":"date-time","description":"Timestamp of when this update was recorded."},"Uri":{"type":"string","description":"Unique URI reference to this action update object."}}}}},"paths":{"/Advertisers/{AccountSID}/ActionUpdates/{ActionUpdateId}":{"get":{"operationId":"getActionUpdateById","tags":["Action Updates"],"summary":"Retrieve an action update","description":"Retrieves the details for a specific update record using its unique ActionUpdateId.","parameters":[{"name":"AccountSID","in":"path","required":true,"description":"Your unique account identifier.","schema":{"type":"string"}},{"name":"ActionUpdateId","in":"path","required":true,"description":"The unique identifier for the action update, obtainable from the list endpoint.","schema":{"type":"string"}}],"responses":{"200":{"description":"Returns an action update object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionUpdate"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v11/reference/actions/action-updates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.