Skip to main content
POST
/
vendor
/
{org_token}
/
screens
/
{screen_id}
Update a Screen
curl --request POST \
  --url https://api.framen.com/vendor/{org_token}/screens/{screen_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "venue_type_id": "<string>",
  "location_id": "<string>",
  "width": 123,
  "height": 123,
  "loop_duration": 123,
  "archived": true,
  "available_for_ads": true,
  "amount": 123,
  "imps_weekly": 123
}
'

​
Update a Screen

Update an existing screen’s details. All body parameters are optional — only include the fields you want to change.
​
org_token
string
required
Your organization token (e.g., Org_4KmTqZnWpLx).
​
screen_id
string
required
The unique identifier of the screen to update.
​
title
string
Display name of the screen.
​
venue_type_id
string
Must be the same as or a child of the parent Location’s venue_type_id.
​
location_id
string
Must reference an existing Location.
​
width
integer
Pixel width of the screen.
​
height
integer
Pixel height of the screen.
​
loop_duration
integer
Loop duration in seconds.
​
archived
boolean
Whether the screen is archived.
​
available_for_ads
boolean
Whether the screen is available for ad campaigns.
​
amount
integer
Number of physical screens this entry represents.
​
imps_weekly
integer
Estimated weekly impressions.
Changing location_id will set the Location’s status to REVIEW, even if it was previously APPROVED.

​
Example Request

curl -X POST https://api.framen.com/vendor/Org_4KmTqZnWpLx/screens/Scr_xYz789 \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Lobby Display A - Updated",
    "width": 3840,
    "height": 2160
  }'
Last modified on April 17, 2026