Update a creative

Changed on

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.

patch/ads-management/v1/creatives/{id}

Request

  • Base URL
    https://apis.roblox.com
  • Auth
    • API key in cookie .ROBLOSECURITY
    • or API key in header x-api-key
    • or OAuth 2
      Authorization codehttps://apis.roblox.com/oauth/v1/authorize
      Token URLhttps://apis.roblox.com/oauth/v1/token
      Scopesad.campaign:write

Path parameters

idstring required

Roblox asset ID in the group ads account selected by groupId, or the caller's personal account when omitted

Query parameters

groupIdstring

Roblox group ID as a decimal string. Selects that group's ads account; requires group advertising permission. Omit for the caller's personal account.

Request body

isArchivedboolean

Archive or unarchive the creative. Archiving must be the only field and requires no enabled ad to use the asset.

universeIdstring nullable

Set the associated experience, or use null to clear it. Omit to keep it unchanged.

Response

OK

assetIdstring

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.

assetNamestring

The display name of the underlying asset.

assetType'IMAGE'

The media type of the asset. Only IMAGE is supported.

billingAccountIdstring

The billing account whose library holds this entry.

createTimestring date-time

The time the creative was added to the library, as an RFC 3339 UTC timestamp.

heightinteger

The height of the asset in pixels. Omitted when unknown.

idstring uuid

The UUID identifying this creative registration. GET and PATCH paths use assetId, not this UUID.

isArchivedboolean

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.

universeIdstring

The identifier of the experience the creative is associated with, if any, as a decimal string. Omitted when not associated with an experience.

updateTimestring date-time

The time the creative was last updated, as an RFC 3339 UTC timestamp.

widthinteger

The width of the asset in pixels. Omitted when unknown.

Changes