picture

Hierarchy: presentation > slides > shapes

A picture shape is used to display images.

Parameter	Type	Input	Description
name	String		[required if shapeId not provided] Name of shape to update/manipulate. Find shape names here.
shapeId	String		[required if name not provided] A unique identifier of a given shape. This ID is not displayed in the document, it's hidden in the xml.
filename	String		[optional] Name of picture file to use OR downloadable URL link (as a string).
settings	Object		[optional] An array of shape-level settings. See settings object for more information.
is_hidden	Boolean	true, false	[optional] Hide shape
remove	Boolean	true, false	[optional] Delete shape

JSON payload

"shapes": [
  {
    "name": "string",
    "filename": "string or downloadable URL",
    "settings": [],
    "is_hidden": boolean,
    "remove": boolean
   },
  {
    "name": "string",
    "filename": "string or downloadable URL",
    "settings": [],
    "is_hidden": boolean,
    "remove": boolean
   } 
]

---

Settings Object

The settings object contain a list format/styling parameters.

Parameter	Type	Input	Description
width	Integer, Float	0 to 5963.92	[optional] Set shape width
height	Integer, Float	0 to 5963.92	[optional] Set shape height
left	Integer, Float	-5963.92 to 5963.92	[optional] Set left position
top	Integer, Float	-5963.92 to 5963.92	[optional] Set top position
unit	String (Enum)	cm, pt, points (default value if ‘unit’ field is not specified)	[optional] Set unit of measurement for shape width, height, left, top

JSON payload

"settings": {
  "height": numeric,
  "width": numeric,
  "top": numeric,
  "left": numeric,
  "unit": "string"
}