> For the complete documentation index, see [llms.txt](https://integrations.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.impact.com/brand-api-reference/brand-api-reference-v11/reference/actions/action-updates.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.