---
title: "Update a campaign"
method: PUT
path: "/api/v2/scorecard/campaigns/{campaign_id}"
tags: ["Scorecards"]
---

# Update a campaign

`PUT /api/v2/scorecard/campaigns/{campaign_id}`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/scorecard/campaigns/{campaign_id}`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `apm_service_catalog_write`, `cases_write`

Updates an existing campaign.

## Path parameters

- `campaign_id` string, required

## Request body

- UpdateCampaignRequest: Request to update a campaign.
  - `data` UpdateCampaignRequestData, required: Data for updating a campaign.
    - `attributes` UpdateCampaignRequestAttributes, required: Attributes for updating a campaign.
      - `description` string: The description of the campaign.
      - `due_date` string, date-time: The due date of the campaign.
      - `entity_scope` string: Entity scope query to filter entities for this campaign.
      - `guidance` string: Guidance for the campaign.
      - `key` string: The unique key for the campaign.
      - `name` string, required: The name of the campaign.
      - `owner_id` string, required: The UUID of the campaign owner.
      - `rule_ids` string[], required: Array of rule IDs associated with this campaign.
      - `start_date` string, date-time, required: The start date of the campaign.
      - `status` string, required: The status of the campaign.
    - `type` 'campaign', required: The JSON:API type for campaigns.

## Response `200`

OK

- CampaignResponse: Response containing campaign data.
  - `data` CampaignResponseData, required: Campaign data.
    - `attributes` CampaignResponseAttributes, required: Campaign attributes.
      - `created_at` string, date-time, required: Creation time of the campaign.
      - `description` string: The description of the campaign.
      - `due_date` string, date-time: The due date of the campaign.
      - `entity_scope` string: Entity scope query to filter entities for this campaign.
      - `guidance` string: Guidance for the campaign.
      - `key` string, required: The unique key for the campaign.
      - `modified_at` string, date-time, required: Time of last campaign modification.
      - `name` string, required: The name of the campaign.
      - `owner` string, required: The UUID of the campaign owner.
      - `start_date` string, date-time, required: The start date of the campaign.
      - `status` string, required: The status of the campaign.
    - `id` string, required: The unique ID of the campaign.
    - `type` 'campaign', required: The JSON:API type for campaigns.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)