Buttondown logo

Get started

Routes

Advertising slotsStatuses

Routes

Listing advertising slotsUpdating an advertising slot

Buttondown logo

Updating an advertising slot

Update an advertising slot's sponsor content and approval status.

Approving content

To approve a slot's content, set content_approved_at to a datetime value. This will automatically clear any rejection status.

Rejecting content

To reject a slot's content, set content_rejection_reason to explain why the content was rejected.

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/advertising_units/slots/{id}"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("PATCH", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "id": "adslot_1328edc3fw896bp4mrhc535z5k",
    "creation_date": "2024-01-01T00:00:00+00:00",
    "date": "2024-12-01",
    "status": "open",
    "invoice_url": null,
    "sku_id": "adsku_0k28edc3fw896bp4mrhc535z5k",
    "submission_url": "http://127.0.0.1:8000/example/sponsorships/submit/11111111-1111-1111-1111-111111111111/",
    "sponsor_company": "",
    "sponsor_email": "",
    "sponsor_name": "",
    "content": "",
    "content_image_id": null,
    "content_url": "",
    "content_approved_at": null,
    "content_rejected_at": null,
    "content_rejection_reason": "",
    "content_submitted_at": null
}

Body parameters

All parameters are optional unless explicitly specified.

content

Type
string
Description

The ad content text.

content_approved_at

Type
string
Description

When the ad content was approved.

content_image_id

Type
string
Description

The ID of the image attached to this ad.

content_rejection_reason

Type
string
Description

The reason the ad content was rejected.

content_url

Type
string
Description

The URL the ad links to.

Type
string
Description

The name of the sponsoring company.

Type
string
Description

The email address of the sponsor contact.

Type
string
Description

The name of the sponsor contact.

status

Type
string
Description

Set to 'approve' or 'reject' to update the content review status.