---
title: "Update a creative"
method: PATCH
path: "/ads-management/v1/creatives/{id}"
---

# Update a creative

`PATCH /ads-management/v1/creatives/{id}`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/ads-management/v1/creatives/{id}`
- 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`

Archives or unarchives a creative, or changes its associated experience. isArchived=true must be the only field in the request; combining it with another field returns 400 without writing. Archiving returns 409 if an enabled ad uses the asset; pause or archive that ad first. Set universeId to null to clear the association; omitted fields remain unchanged. An empty object returns the current creative without writing. The asset is resolved only in the group ads account selected by groupId, or the caller's personal account when omitted. Unknown assets and inaccessible accounts return the same 404. The caller must have advertising permission for a new experience association.

## Path parameters

- `id` string, required

## Query parameters

- `groupId` string

## Request body

- UpdateCreativeRequest
  - `isArchived` boolean: Archive or unarchive the creative. Archiving must be the only field and requires no enabled ad to use the asset.
  - `universeId` string, nullable: Set the associated experience, or use null to clear it. Omit to keep it unchanged.

## Response `200`

OK

- Creative
  - `assetId` string: The Roblox asset ID identifying this creative, as a decimal string. Use this assetId in GET and PATCH /creatives/{id}, not the registration UUID in id. groupId selects the group ads account; absent groupId selects the personal ads account.
  - `assetName` string: The display name of the underlying asset.
  - `assetType` 'IMAGE': The media type of the asset. Only `IMAGE` is supported.
  - `billingAccountId` string: The billing account whose library holds this entry.
  - `createTime` string, date-time: The time the creative was added to the library, as an RFC 3339 UTC timestamp.
  - `height` integer: The height of the asset in pixels. Omitted when unknown.
  - `id` string, uuid: The UUID identifying this creative registration. GET and PATCH paths use assetId, not this UUID.
  - `isArchived` boolean: Whether the creative has been archived (soft-deleted).
  - `moderationStatus` 'PENDING_REVIEW' | 'APPROVED' | 'REJECTED': The content-review outcome for the asset. Can be `PENDING_REVIEW`, `APPROVED`, or `REJECTED`.
  - `source` 'UPLOAD' | 'IN_HOUSE_GEN_AI': How the asset was produced. Can be `UPLOAD` or `IN_HOUSE_GEN_AI`.
  - `universeId` string: The identifier of the experience the creative is associated with, if any, as a decimal string. Omitted when not associated with an experience.
  - `updateTime` string, date-time: The time the creative was last updated, as an RFC 3339 UTC timestamp.
  - `width` integer: The width of the asset in pixels. Omitted when unknown.

## Other responses

- `400`: Invalid request
- `403`: Permission denied for the new experience
- `404`: Creative not found
- `409`: Creative is used by an enabled ad, or conflicting concurrent change
- `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/creatives/:id/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)
