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
}

API recipes

Emails

Subscribers

Tags

Images

Advertising slots

Attachments

Newsletters

Exports

Bulk actions

RSS feeds

Webhooks

Comments

Surveys

Coupons

Automations

Accounts

Notes

Prices

API Requests

Events

Ping

Changelog

Approving content

Rejecting content

Sample requests

Sample responses

Body parameters

content

content_approved_at

content_image_id

content_rejection_reason

content_url

sponsor_company

sponsor_email

sponsor_name

status