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.