---
title: "Toggle one ad on or off"
method: PATCH
path: "/ads-management/v1/campaigns/{campaignId}/ads/{adId}"
---

# Toggle one ad on or off

`PATCH /ads-management/v1/campaigns/{campaignId}/ads/{adId}`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/campaigns/{campaignId}/ads/{adId}`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `ad.campaign:write`

Sets one ad's status to ACTIVE or PAUSED while leaving the campaign's creative set, targeting, and other ads unchanged. Returns 400 FAILED_PRECONDITION for REMOVED ads and for campaigns that have ended or been cancelled.

## Path parameters

- `campaignId` string, required
- `adId` string, required

## Request body

- UpdateCampaignAdRequest
  - `status` 'ACTIVE' | 'PAUSED', required: Target lifecycle status (`ACTIVE` or `PAUSED`).

## Response `200`

OK

- CampaignAd
  - `creativeAssetId` string, required: The Roblox image asset ID this ad serves, as a decimal string. This is the same value as Creative.assetId.
  - `deliveryStatus` 'SERVING' | 'IN_REVIEW' | 'NOT_SERVING' | 'REJECTED', required: Per-ad serving state (`SERVING`, `IN_REVIEW`, `NOT_SERVING`, or `REJECTED`).
  - `id` string, required: Stable ad ID; matches the ad ID in analytics-query-api.
  - `removeTime` string, date-time: Set when status is `REMOVED`, as an RFC 3339 UTC timestamp.
  - `reviewIssues` Reason[]: Structured review issues, when applicable.
    - `code` string, required: A stable, machine-readable code.
    - `message` string, required: A human-readable explanation.
    - `remediation` string: What the caller can do to resolve it.
    - `resource` string: The related resource, for example `billing-accounts/123`.
  - `reviewStatus` 'IN_REVIEW' | 'APPROVED' | 'REJECTED', required: Combined result of the creative's review and the experience's review (`IN_REVIEW`, `APPROVED`, or `REJECTED`).
  - `status` 'ACTIVE' | 'PAUSED' | 'REMOVED', required: Lifecycle intent for this ad (`ACTIVE`, `PAUSED`, or `REMOVED`).

## Other responses

- `400`: Validation error or failed precondition
- `403`: Permission denied
- `404`: Campaign or ad not found
- `409`: Concurrent modification conflict
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-11-16** `a94d3bd77d7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/ads-management/v1/campaigns/:campaignId/ads/:adId/patch.md)

---

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