The Sketch Field captures sketch data with the following properties:
background
- A photo or image that represents the background of the drawing.drawing
- An image that represents the drawing on top of thebackground
image.
{
"Sketch 1": {
"background": null,
"drawing": {
"id": "770486b6-39ed-4965-9766-7037416a7162",
"link": "https://api.goformz.com/v2/files/770486b6-39ed-4965-9766-7037416a7162"
},
"raw": "{\"objects\":[ ... ]}", //omitted for brevity
"version": 2,
"id": "d61bfeeb-9db6-499d-8dec-a46c0108d3ca",
"name": "Sketch 1",
"type": "Sketch"
}
}
NOTE:
The id, name, and type are not necessary when setting or updating the Sketch Field. These properties are returned in the JSON of the request for readability.
The background
and drawing
properties are File
property types and each have the following properties:
id
- Theid
of an image uploaded to theFiles
endpoint.link
- A downloadablelink
to that image or photo's location in storage.
NOTE:
The
link
property is read-only and will not be persisted if it is updated.
The background
file and the drawing
file require uploading a File
first and then assigning that uploaded file's id
to that property's id
property. For more details see the section: "Uploading a file".