Sign in

v4

latestOpenAPI 3.1.0MIT2026-08-02128224900.7 KB
Advertising Units

Update Advertising Slot

Update an advertising slot's sponsor content

patch/advertising_units/slots/{id}

Path parameters

idstring required

Request body

contentstring nullable

The ad content text.

content_approved_atstring date-time nullable

When the ad content was approved.

content_image_idstring nullable

The ID of the image attached to this ad.

content_rejection_reasonstring nullable

The reason the ad content was rejected.

content_urlstring nullable

The URL the ad links to.

sponsor_companystring nullable

The name of the sponsoring company.

sponsor_emailstring nullable

The email address of the sponsor contact.

sponsor_namestring nullable

The name of the sponsor contact.

status'approve' | 'hold_accept' | 'hold_decline' | 'reject' nullable

Set to 'approve', 'reject', 'hold_accept', or 'hold_decline' to update the slot status.

Response

OK

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

datestring date required

The date this advertising slot is scheduled for.

status'expired' | 'executed' | 'finalized' | 'held' | 'open' | 'sold' required

An enumeration.

invoice_urlstring nullable

URL to the Stripe invoice PDF for this slot, if available.

sku_idstring required

The ID of the advertising unit this slot belongs to.

submission_urlstring required

URL where the sponsor can submit their ad content.

sponsor_companystring required

The name of the sponsoring company.

sponsor_emailstring required

The email address of the sponsor contact.

sponsor_namestring required

The name of the sponsor contact.

contentstring required

The ad content text.

content_image_idstring nullable

The ID of the image attached to this ad, if any.

content_urlstring required

The URL the ad links to.

content_approved_atstring date-time nullable

When the ad content was approved, if applicable.

content_rejected_atstring date-time nullable

When the ad content was rejected, if applicable.

content_rejection_reasonstring required

The reason the ad content was rejected, if applicable.

content_submitted_atstring date-time nullable

When the ad content was submitted for review.

inquiry_messagestring required

Optional message from the sponsor inquiry.