---
title: "POST /#X-Amz-Target=IoTAutobahnControlPlane.UpdateCampaign"
method: POST
path: "/#X-Amz-Target=IoTAutobahnControlPlane.UpdateCampaign"
---

# POST /#X-Amz-Target=IoTAutobahnControlPlane.UpdateCampaign

`POST /#X-Amz-Target=IoTAutobahnControlPlane.UpdateCampaign`

Updates a campaign.

## Headers

- `X-Amz-Target` 'IoTAutobahnControlPlane.UpdateCampaign', required

## Request body

- UpdateCampaignRequest
  - `name` string, required — The name of the campaign to update.
  - `description` string — The description of the campaign.
  - `dataExtraDimensions` NodePath[] — <p> A list of vehicle attributes to associate with a signal. </p> <p>Default: An empty array</p>
  - `action` 'APPROVE' | 'SUSPEND' | 'RESUME' | 'UPDATE', required — <p> Specifies how to update a campaign. The action can be one of the following:</p> <ul> <li> <p> <code>APPROVE</code> - To approve delivering a data collection scheme to vehicles. </p> </li> <li> <p> <code>SUSPEND</code> - To suspend collecting signal data. The campaign is deleted from vehicles and all vehicles in the suspended campaign will stop sending data.</p> </li> <li> <p> <code>RESUME</code> - To reactivate the <code>SUSPEND</code> campaign. The campaign is redeployed to all vehicles and the vehicles will resume sending data.</p> </li> <li> <p> <code>UPDATE</code> - To update a campaign. </p> </li> </ul>

## Response `200`

Success

- UpdateCampaignResponse
  - `arn` string — The Amazon Resource Name (ARN) of the campaign.
  - `name` string — The name of the updated campaign.
  - `status` 'CREATING' | 'WAITING_FOR_APPROVAL' | 'RUNNING' | 'SUSPENDED' — <p>The state of a campaign. The status can be one of:</p> <ul> <li> <p> <code>CREATING</code> - Amazon Web Services IoT FleetWise is processing your request to create the campaign. </p> </li> <li> <p> <code>WAITING_FOR_APPROVAL</code> - After you create a campaign, it enters this state. Use the API operation to approve the campaign for deployment to the target vehicle or fleet. </p> </li> <li> <p> <code>RUNNING</code> - The campaign is active. </p> </li> <li> <p> <code>SUSPENDED</code> - The campaign is suspended. To resume the campaign, use the API operation. </p> </li> </ul>

## Other responses

- `480` — ResourceNotFoundException
- `481` — InternalServerException
- `482` — ConflictException
- `483` — ThrottlingException
- `484` — ValidationException
- `485` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/iotfleetwise.md) · [All operations](https://skmtc.net/aws/apis/iotfleetwise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotfleetwise/versions/0f1f9edeb409/schema)