Update a Screen

POST /vendor//screens/

POST /vendor/{org_token}/screens/{screen_id}

Send only the fields you want to change. Omitted fields are left unchanged.

Path parameters

Parameter	Type	Required	Description
org_token	string	Yes	Your organization token (find it here)
screen_id	string	Yes	The screen ID

Request body

Field	Type	Notes
title	string
venue_type_id	string	Must still satisfy the parent-child constraint
location_id	string	Moving a screen to a new location resets that location’s status to REVIEW
width	int
height	int
loop_duration	int	In seconds
archived	boolean
available_for_ads	boolean
amount	int
imps_weekly	int

Changing a screen’s location_id resets the new location’s status to REVIEW, even if it was previously APPROVED. This may temporarily disrupt ad delivery at the destination location.

Example request

curl -X POST "https://api.framen.com/vendor/Org_9WeJxcVrRnM/screens/d3c8dbb6-c21b-4b26-8f35-d73260c95fa1" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Entrance Display Left (Updated)",
    "available_for_ads": false
  }'

Response

Returns the updated screen object.