Returns the Roblox asset registered in the selected ads account. The path id is Creative.assetId, a decimal Roblox asset ID, not Creative.id (the library registration UUID). For example, assetId "1234567890" uses /creatives/1234567890. A registration UUID returns 404. groupId selects the group ads account; absent groupId selects the personal ads account. The caller needs group advertising permission. Unknown and inaccessible creatives return the same 404.

get/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:read

Path parameters

idstring required

Roblox asset ID (Creative.assetId) in the group ads account selected by groupId, or the personal ads account when absent

Query parameters

groupIdstring

Select the group ads account; absent groupId selects the personal ads account. Requires group advertising permission

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