Retrieve Flashback Images

Retrieve Flashback Images:  GET /flashbacks

Retrieves a list of image files for a specified timeline.

Contents

Uses and Requirements

GET /flashbacks retrieves a list of image files for a specified timeline.

This end point allows you to retrieve the image files which have been created on a specified day, during specified week, or durig specified month, as indicated by the duration parameter. The from parameter indicates the year before which the flashback images are to be retrieved.

You can specify one of the following values for the duration parameter:

  • day
    The API creates a flashback story for a specified day in each year starting with a year before the year specified by the from parameter.
  • week (default)
    The API checks in which week of year the specified date is. It then creates a flashback story by grouping all items from that week for each year, starting with a year before the specified year in the from parameter.
  • month
    The API checks in which month the specified date is. It then creates a flashback story by grouping all items from that month for each year, starting with a year before the year specified in the from parameter.

Request Components

HTTP Request

GET https://api.cloudapi.verizon.com/cloud/1/flashbacks 

Header Parameters

Parameter Name Data Type Description
Authorization
required
string Must contain an OAuth 2.0 access token obtained by calling the authentication API.

Path Parameters

None

Query Parameters

Parameter Name Data Type Description
count
optional
integer The maximum number of image files to be returned per year. Defaults to 1.
duration
optional
string The optional flashbacks duration. Possible values are:
  • day
  • week (default)
  • month
from
optional
string The start date for wich the flashback images are to be generated. The date is in UTC format and inclusive. Defaults to the current date.
Example: 2017-05-25T06:50:39.000Z.
virtualfolder
optional
string Folder that represents a client type at the root level and contains the respective data. Defaults to VZMOBILE.

Request Body

None

Success Responses

  • Status 200
  • Status 204 - indicates that there are no image files in the specified virtual folder.

  • flashback_response

Parameter Name Data Type Description
flashback flashback_list A set of images for each time frame
latest image_flashback_response The latest captured image with an image score
  • image_flashback_response
Parameter Name Data Type Description
name string The name of the file
parentPath string The folder where the file is located
systemAttributes object A set of file attributes. Varies depending on the file type.

Example Success Response

  • Example Success Respose with duration parameter set to day
{
	"flashbacks": {
		"2014": [{
			"name": "2014-05-25 195011-935299.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-25T23:50:11.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "T8c63D8O8JA=",
						"npf": false,
						"iqs": 1.990170955657959,
						"ss": 1.990170955657959,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-25 022326-973008.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-25T06:23:26.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "PmkbKtLy8Qw=",
						"npf": false,
						"iqs": -0.4567280113697052,
						"ss": -0.4567280113697052,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-25 020601-671786.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-25T06:06:01.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "+M01MorKjTI=",
						"npf": false,
						"iqs": -0.7572230100631714,
						"ss": -0.7572230100631714,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-25 015612-542964.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-25T05:56:12.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "wKO7KtrS82w=",
						"npf": false,
						"iqs": -0.32959601283073425,
						"ss": -0.32959601283073425,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-25 182017-799714.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-25T22:20:17.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "1hY5tYER4Vw=",
						"npf": false,
						"iqs": -0.0012710000155493617,
						"ss": -0.0012710000155493617,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}]
	},
	"latest": {
		"name": "2017-01-25 181415-1918998.JPG",
		"systemAttributes": {
			"CaptureDate": "2017-01-25T23:14:15.000Z",
			"imagescore": {
				"ImageQuality": {
					"nds": "wGB-P8HkOYA=",
					"npf": false,
					"iqs": 0.6969249844551086,
					"ss": 0.6969249844551086,
					"ver": "1c",
					"fds": 0
				}
			}
		},
		"parentPath": "/VZMOBILE/iPhone"
	}
}
  • Example Success Respose with duration parameter set to week
{
	"flashbacks": {
		"2014": [{
			"name": "2014-05-24 131939-383400.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-24T17:19:39.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "gnx5jTZ4xxo=",
						"npf": false,
						"iqs": -0.6073619723320007,
						"ss": -0.6073619723320007,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-24 185201-401597.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-24T22:52:01.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "1oUxt4pMPRo=",
						"npf": false,
						"iqs": -0.5084080100059509,
						"ss": -0.5084080100059509,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-21 205552-300268.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-22T00:55:52.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "lxESwxjCQRg=",
						"npf": false,
						"iqs": -0.5826240181922913,
						"ss": -0.5826240181922913,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-23 145912-403629.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-23T18:59:12.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "gd9pHTfhYJI=",
						"npf": false,
						"iqs": -0.8176379799842834,
						"ss": -0.8176379799842834,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2014-05-21 205548-298073.JPG",
			"systemAttributes": {
				"CaptureDate": "2014-05-22T00:55:48.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "lzUYwxCYQxg=",
						"npf": false,
						"iqs": -0.6197310090065002,
						"ss": -0.6197310090065002,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}],
		"2015": [{
			"name": "2015-05-23 152057-1617153.JPG",
			"systemAttributes": {
				"CaptureDate": "2015-05-23T19:20:57.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "NB3so9vEc7g=",
						"npf": false,
						"iqs": 1.2109110355377197,
						"ss": 1.2109110355377197,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}]
	},
	"latest": {
		"name": "2017-01-25 181415-1918998.JPG",
		"systemAttributes": {
			"CaptureDate": "2017-01-25T23:14:15.000Z",
			"imagescore": {
				"ImageQuality": {
					"nds": "wGB-P8HkOYA=",
					"npf": false,
					"iqs": 0.6969249844551086,
					"ss": 0.6969249844551086,
					"ver": "1c",
					"fds": 0
				}
			}
		},
		"parentPath": "/VZMOBILE/iPhone"
	}
}
  • Example Success Respose with duration parameter set to month
{
	"flashbacks": {
		"2013": [{
			"name": "20130517_120128.jpg",
			"systemAttributes": {
				"CaptureDate": "2013-05-17T07:01:27.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "Ad-_AMErDmA=",
						"npf": false,
						"iqs": 0.20050020515918732,
						"ss": 1.2282025814056396,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-G900H"
		}, {
			"name": "20130517_120137.jpg",
			"systemAttributes": {
				"CaptureDate": "2013-05-17T07:01:37.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "xy15EuDAOkY=",
						"npf": false,
						"iqs": -0.48270612955093384,
						"ss": -0.19651727378368378,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20130517_120139.jpg",
			"systemAttributes": {
				"CaptureDate": "2013-05-17T07:01:38.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "x2_5EODEO0w=",
						"npf": false,
						"iqs": -0.31973952054977417,
						"ss": 0.14137500524520874,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20130517_120135(0).jpg",
			"systemAttributes": {
				"CaptureDate": "2013-05-17T07:01:35.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "xy15EmDEOkQ=",
						"npf": false,
						"iqs": -0.24075479805469513,
						"ss": 0.321321040391922,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20130517_120136.jpg",
			"systemAttributes": {
				"CaptureDate": "2013-05-17T07:01:36.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "xy95EODEO0Q=",
						"npf": false,
						"iqs": 0.005353815853595734,
						"ss": 1.2445510625839233,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}],
		"2014": [{
			"name": "20140517_120059.jpg",
			"systemAttributes": {
				"CaptureDate": "2014-05-17T07:00:59.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "FUGja4LP4CA=",
						"npf": false,
						"iqs": -0.1262630671262741,
						"ss": 0.13459374010562897,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20140517_120103.jpg",
			"systemAttributes": {
				"CaptureDate": "2014-05-17T07:01:02.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "A0Ghb4Bj8DA=",
						"npf": false,
						"iqs": 0.17875154316425323,
						"ss": 1.1074758768081665,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20140517_120053.jpg",
			"systemAttributes": {
				"CaptureDate": "2014-05-17T07:00:53.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "krcllJKtL1o=",
						"npf": false,
						"iqs": 0.38863077759742737,
						"ss": 0.7455975413322449,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20140517_120105.jpg",
			"systemAttributes": {
				"CaptureDate": "2014-05-17T07:01:04.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "K1uXEMQtgHQ=",
						"npf": false,
						"iqs": -0.34280988574028015,
						"ss": -0.3729360103607178,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}, {
			"name": "20140517_120106.jpg",
			"systemAttributes": {
				"CaptureDate": "2014-05-17T07:01:06.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "K3uXEMwtgHQ=",
						"npf": false,
						"iqs": 0.08784595876932144,
						"ss": 0.6075292229652405,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/My Samsung SM-XXXXX"
		}],
		"2015": [{
			"name": "2015-05-24 160243-524068.JPG",
			"systemAttributes": {
				"CaptureDate": "2015-05-24T20:02:43.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "ClTt/T2BseA=",
						"npf": false,
						"iqs": 0.6914049983024597,
						"ss": 0.6914049983024597,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2015-05-24 115312-1223083.JPG",
			"systemAttributes": {
				"CaptureDate": "2015-05-24T15:53:12.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "bw1tk5JswYA=",
						"npf": false,
						"iqs": 0.7408810257911682,
						"ss": 0.7408810257911682,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2015-05-23 152057-1617153.JPG",
			"systemAttributes": {
				"CaptureDate": "2015-05-23T19:20:57.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "NB3so9vEc7g=",
						"npf": false,
						"iqs": 1.2109110355377197,
						"ss": 1.2109110355377197,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2015-05-24 135631-1415510.JPG",
			"systemAttributes": {
				"CaptureDate": "2015-05-24T17:56:31.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "+fqZB7IYAYg=",
						"npf": false,
						"iqs": 1.285125970840454,
						"ss": 1.285125970840454,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}, {
			"name": "2015-05-24 132321-1404381.JPG",
			"systemAttributes": {
				"CaptureDate": "2015-05-24T17:23:21.000Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "UrXoBm+I57A=",
						"npf": false,
						"iqs": 2.1262319087982178,
						"ss": 2.1262319087982178,
						"ver": "1c",
						"fds": 0
					}
				}
			},
			"parentPath": "/VZMOBILE/iPhone"
		}],
		"2016 ": [{
			"name ": "20160505 _133744.jpg ",
			"systemAttributes ": {
				"CaptureDate ": "2016 - 05 - 05 T08: 37: 44.000 Z",
				"imagescore ": {
					"ImageQuality ": {
						"nds": "ESjn02pt1Fo = ",
						"npf": false,
						"iqs ": -0.7613043785095215,
						"ss ": 0.832617998123169,
						"ver": "1 c",
						"fds": 0
					}
				}
			},
			"parentPath": " / VZMOBILE / My Samsung SM - XXXXX "
		}, {
			"name": "20160505 _133746.jpg",
			"systemAttributes": {
				"CaptureDate": "2016 - 05 - 05 T08: 37: 46.000 Z",
				"imagescore": {
					"ImageQuality": {
						"nds": "xx35KY7CCOA = ",
						"npf": false,
						"iqs": -0.724471926689148,
						"ss": -0.038920313119888306,
						"ver": "1 c",
						"fds": 0
					}
				}
			},
			"parentPath": " / VZMOBILE / My Samsung SM - XXXXX"
		}]
	},
	"latest": {
		"name": "2017 - 01 - 25 181415 - 1918998. JPG",
		"systemAttributes": {
			"CaptureDate": "2017 - 01 - 25 T23: 14: 15.000 Z",
			"imagescore": {
				"ImageQuality": {
					"nds": "wGB - P8HkOYA =",
					"npf": false,
					"iqs": 0.6969249844551086,
					"ss": 0.6969249844551086,
					"ver": "1 c ",
					"fds": 0
				}
			}
		},
		"parentPath": "/VZMOBILE/iPhone"
	}
}

Failure Responses

  • Status 400
  • Status 401
  • Status 403
  • Status 404
  • Status 503

SEE ALSO:

{
	"swagger": "2.0",
	"info": {
		"title": "Personal Cloud Storage APIs",
		"version": "1"
	},
	"host": "api.cloudapi.verizon.com",
	"schemes": [
		"https"
	],
	"basePath": "/cloud/1",
	"paths": {
		"/flashbacks": {
			"get": {
				"operationId": "get_flashbacks",
				"produces": [
					"application/json"
				],
				"consumes": [
					"application/json"
				],
				"summary": "Get the flashbacks.",
				"description": "Fetch the flashback (Only image files having CaptureDate & image score) for the specified timeline. If 'from' is year n - response returns images from n-1, n-2 and so on & latest.",
				"parameters": [
					{
						"$ref": "#/parameters/virtualfolderFullview"
					},
					{
						"name": "from",
						"in": "query",
						"description": "The date for which flashbacks need to be generated. The date is UTC. Defaulted to the current date. (Example: 2017-05-25T06:50:39.000Z)",
						"required": false,
						"type": "string"
					},
					{
						"name": "duration",
						"in": "query",
						"description": "The optional flashbacks duration. Possible values are: day or week or month. Defaulted to week.",
						"required": false,
						"type": "string",
						"enum": [
							"day",
							"week",
							"month"
						]
					},
					{
						"name": "count",
						"in": "query",
						"description": "The maximum number of image files to be returned per year. Defaulted to 1.",
						"required": false,
						"type": "integer"
					}
				],
				"responses": {
					"200": {
						"description": "A flashback response object",
						"schema": {
							"$ref": "#/definitions/flashback_response"
						}
					},
					"204": {
						"description": "OK. [The virtual folder is having no image files with image score.]"
					},
					"400": {
						"description": "[Bad Request] Query parameters missing or invalid.",
						"schema": {
							"$ref": "#/definitions/error_response"
						}
					},
					"401": {
						"description": "[Unauthorized] Bearer token is missing, expired, or invalid.",
						"schema": {
							"$ref": "#/definitions/error_response"
						}
					},
					"403": {
						"description": "[Forbidden] User is not authorized to access storage APIs.",
						"schema": {
							"$ref": "#/definitions/error_response"
						}
					},
					"404": {
						"description": "[Not Found] File was not found.",
						"schema": {
							"$ref": "#/definitions/error_response"
						}
					},
					"503": {
						"description": "[Service Unavailable] See response body for more detail.",
						"schema": {
							"$ref": "#/definitions/error_response"
						}
					}
				},
				"tags": [
					"Try it Out"
				],
				"security": [
					{
						"files_auth": []
					}
				]
			}
		}
	},
	"parameters": {
		"uploadid": {
			"name": "uploadid",
			"in": "path",
			"description": "Unique id to upload file binary content and to create the file. Uploadid is obtained via a call to the /fileupload/intent API (it is embedded in the URLs included in the response).",
			"required": true,
			"type": "string"
		},
		"filepath": {
			"name": "path",
			"in": "query",
			"description": "The path to the folder where file has to be uploaded.",
			"required": true,
			"type": "string"
		},
		"filename": {
			"name": "name",
			"in": "query",
			"description": "Name of the file to be uploaded.",
			"required": true,
			"type": "string"
		},
		"filesize": {
			"name": "size",
			"in": "query",
			"description": "Size of the file to be uploaded.",
			"required": true,
			"type": "integer"
		},
		"offset": {
			"name": "offset",
			"in": "query",
			"description": "Required when chunk parameter value is set to true. Represents sequence of the uploaded chunk data.",
			"required": false,
			"type": "integer"
		},
		"etag": {
			"name": "X-Header-ETag",
			"in": "header",
			"description": "Omit this header to request a full response.  To request only changes since a previous call to fullview, include this header as copied from your previous /fullview response.",
			"required": false,
			"type": "string"
		},
		"path": {
			"name": "path",
			"in": "path",
			"description": "The path to the file or folder.",
			"required": true,
			"type": "string"
		},
		"purge": {
			"name": "purge",
			"in": "query",
			"description": "If 'true', permanently deletes the file/folder.",
			"required": false,
			"type": "boolean",
			"default": false
		},
		"content-token": {
			"name": "content-token",
			"in": "path",
			"description": "The file's content token (obtained from a call to /metadata or /fullview).",
			"required": true,
			"type": "string"
		},
		"size": {
			"name": "size",
			"in": "query",
			"type": "string",
			"description": "Thumbnail size: 'xs' (24x24), 's' (64x64), 'm' (128x128) or 'l' (320x320). Either 'size' or 'th' and 'tw' are required."
		},
		"th": {
			"name": "th",
			"in": "query",
			"type": "integer",
			"description": "Thumbnail height (in pixels). Either 'size' or 'th' and 'tw' are required."
		},
		"tw": {
			"name": "tw",
			"in": "query",
			"type": "integer",
			"description": "Thumbnail width (in pixels). Either 'size' or 'th' and 'tw' are required."
		},
		"include_deleted": {
			"name": "include_deleted",
			"in": "query",
			"description": "if true, response will include deleted files and folders. Default is false.",
			"required": false,
			"type": "boolean",
			"default": false
		},
		"query": {
			"name": "query",
			"in": "query",
			"description": "Contains the text to be searched and supports a number of query fields that allow clients to restrict the search to particular parts of a file's or folder's metadata",
			"required": true,
			"type": "string"
		},
		"sort": {
			"name": "sort",
			"in": "query",
			"description": "Specify sort order for response. Syntax is :'{field}+{asc|desc}'.  Valid values for 'field' are: name, versionCreated, size, extension, album, artist, captureDate, compilation, contentType, creationDate, favorite, genre, height, modificationDate, priority, source, tags, title, timelineDate",
			"required": false,
			"type": "string"
		},
		"sort_metadata": {
			"name": "sort",
			"in": "query",
			"description": "Specify sort order for response. Syntax is :'{field}+{asc|desc}'.  Valid values for 'field' are: name, versionCreated, size, extension, album, artist, captureDate, contentType, creationDate, genre, priority, title, timelineDate",
			"required": false,
			"type": "string"
		},
		"query_contact": {
			"name": "query",
			"in": "query",
			"description": "Contains the text to be searched to particular parts of a contact. Supports following fields: id, name, email, im, address, tel, incaseofemergency (Example: incaseofemergency:true and incaseofemergency:false), field-tag.type (Example: address.home), address.type.subfield (Example: address.home.street), favorite (Example: favorite:true and favorite:false)",
			"required": false,
			"type": "string"
		},
		"sort_contact": {
			"name": "sort",
			"in": "query",
			"description": "Specify sort order for response. Syntax is :'{field}+{asc|desc}'.  Valid values for 'field' are: firstname, lastname, created, modified, id",
			"required": false,
			"type": "string"
		},
		"page": {
			"name": "page",
			"in": "query",
			"description": "Page number to return, for paginated responses. Defaulted to 1 if count is specified.",
			"required": false,
			"type": "integer"
		},
		"page_contact": {
			"name": "page",
			"in": "query",
			"description": "Page number to return, for paginated responses. Defaulted to 1.",
			"required": false,
			"type": "integer"
		},
		"count": {
			"name": "count",
			"in": "query",
			"description": "Maximum children to include in a paginated response.  Defaulted to 20 if page is specified.",
			"required": false,
			"type": "integer"
		},
		"count_contact": {
			"name": "count",
			"in": "query",
			"description": "Maximum children to include in a paginated response.  Defaulted to 200.",
			"required": false,
			"type": "integer"
		},
		"count_share": {
			"name": "count",
			"in": "query",
			"description": "Maximum items to include in a paginated response, for share requests.Value must be between 1 and 200. Default is 20",
			"required": false,
			"type": "integer"
		},
		"filter": {
			"name": "filter",
			"in": "query",
			"description": "Set to 'file' or 'folder', to include only those types of items in the response.",
			"required": false,
			"type": "string"
		},
		"type": {
			"name": "type",
			"in": "query",
			"description": "The type of the playlist. Can be one of 'image', 'music', 'video' or 'image-video'.",
			"required": false,
			"type": "string"
		},
		"playlistUid": {
			"name": "playlistUid",
			"in": "path",
			"description": "Unique id related to a specific playlist.",
			"required": true,
			"type": "string"
		},
		"location_download": {
			"name": "location",
			"in": "query",
			"description": "Location as returned in the POST /shares response under 'resources'.",
			"required": true,
			"type": "string"
		},
		"serv_download": {
			"name": "serv",
			"in": "query",
			"description": "serv as returned in the 'url' under 'resources'.",
			"required": true,
			"type": "string"
		},
		"inviteKey_download": {
			"name": "inviteKey",
			"in": "query",
			"description": "publicInviteKey as returned in the POST /shares response.",
			"required": true,
			"type": "string"
		},
		"contactID": {
			"name": "contactID",
			"in": "path",
			"description": "Unique id related to a specific contact.",
			"required": true,
			"type": "string"
		},
		"itemUid": {
			"name": "itemUid",
			"in": "path",
			"description": "Unique id related to a specific item in a playlist.",
			"required": true,
			"type": "string"
		},
		"deep": {
			"name": "deep",
			"in": "query",
			"description": "Specifies whether the search should stop at the topmost deleted item in the tree (deep=false), or navigate into it and list all the deleted contents    (deep=true).",
			"required": false,
			"type": "boolean",
			"default": false
		},
		"virtualfolder": {
			"name": "virtualfolder",
			"in": "query",
			"description": "Folder that represents various client types at the root level and contains their respective data.",
			"required": true,
			"type": "string"
		},
		"virtualfolderFullview": {
			"name": "virtualfolder",
			"in": "query",
			"description": "Folder that represents various client types at the root level and contains their respective data. Defaulted to VZMOBILE.",
			"required": false,
			"type": "string"
		},
		"virtualfolderSearch": {
			"name": "virtualfolder",
			"in": "query",
			"description": "Folder that represents various client types at the root level and contains their respective data. Defaulted to VZMOBILE. For search across all virtual folders, give value as '*'",
			"required": false,
			"type": "string"
		},
		"filter_share": {
			"name": "filter",
			"in": "query",
			"description": "Filters the returned shares. Currently the value can only be 'outbound' (shared by the user).",
			"required": false,
			"default": "outbound",
			"type": "string"
		},
		"since": {
			"name": "since",
			"in": "query",
			"description": "The date and time, expressed in the W3C date and time format, after which messages should be returned.",
			"required": false,
			"type": "string"
		},
		"until": {
			"name": "until",
			"in": "query",
			"description": "The date and time, expressed in the W3C date and time format, up to which messages should be returned.",
			"required": false,
			"type": "string"
		},
		"cursor": {
			"name": "cursor",
			"in": "query",
			"description": "A cursor used in paginating the response. Cursors are returned in 'next' and 'prev' links in the response body. When cursor parameter is present other parameter values are ignored",
			"required": false,
			"type": "string"
		},
		"shareUid": {
			"name": "shareUid",
			"in": "path",
			"description": "The unique ID of the share.",
			"required": true,
			"type": "string"
		},
		"type_favorite": {
			"name": "type",
			"in": "query",
			"description": "Allow clients to restrict the listing favorites to files, folders or both",
			"required": false,
			"type": "string",
			"enum": [
				"file",
				"folder",
				"filefolder"
			],
			"default": "filefolder"
		},
		"filetype_favorite": {
			"name": "filetype",
			"in": "query",
			"description": "Allow clients to restrict the listing favorites to file of a single type - 'image', 'music', 'video', 'documents' or ‘all’",
			"required": false,
			"type": "string",
			"enum": [
				"image",
				"music",
				"video",
				"documents",
				"all"
			],
			"default": "all"
		},
		"createVirtualFolderName": {
			"name": "name",
			"in": "path",
			"description": "Name of the virtual folder",
			"required": true,
			"type": "string"
		}
	},
	"definitions": {
		"base_file_metadata": {
			"required": [
				"name",
				"parentPath",
				"checksum",
				"contentAccessible",
				"contentToken",
				"deleted",
				"extension",
				"size",
				"systemAttributes",
				"version",
				"versionCreated",
				"viewUid",
				"uri",
				"ciComplete",
				"contentPermissions"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the file"
				},
				"parentPath": {
					"type": "string",
					"description": "The folder where the file is located"
				},
				"checksum": {
					"type": "string",
					"description": "The file content's SHA-256 checksum value"
				},
				"contentAccessible": {
					"type": "boolean",
					"description": "If false, the file content is protected by copywrite and is not accessible to the user"
				},
				"contentToken": {
					"type": "string",
					"description": "A unique string representing the file. Will change if file content is updated.  Required for certain APIs, such as /thumbnails"
				},
				"deleted": {
					"type": "boolean",
					"description": "If true, the file has been logically deleted"
				},
				"extension": {
					"type": "string",
					"description": "The file's extension, as extracted from the filename"
				},
				"size": {
					"type": "integer",
					"format": "int64",
					"description": "The size of the file, in bytes"
				},
				"systemAttributes": {
					"description": "A set of file attributes.  The attribute set will vary depending on file type"
				},
				"version": {
					"type": "integer",
					"description": "File version.  This number increases when the file is updated"
				},
				"versionCreated": {
					"type": "string",
					"description": "Creation timestamp for the file's current version, in ISO-8601 format"
				},
				"viewUid": {
					"type": "array",
					"description": "Array of viewUid",
					"items": {
						"$ref": "#/definitions/viewUid"
					}
				},
				"uri": {
					"type": "string",
					"description": "Unique identifier of the resource"
				},
				"ciComplete": {
					"type": "boolean",
					"description": "Whether the content ingestion step has been completed on the file"
				},
				"contentPermissions": {
					"type": "string",
					"description": "Determines a file's accessibility. It can take the following values: SHARE(file has no restrictions and is shareable), VIEW(file is not shareable. All other operations are permitted) & BLOCK(file is not accessible. Only delete operation permitted)"
				}
			}
		},
		"file_metadata": {
			"allOf": [
				{
					"$ref": "#/definitions/base_file_metadata"
				},
				{
					"properties": {
						"shareAssociation": {
							"type": "array",
							"description": "Array of shareAssociation",
							"items": {
								"$ref": "#/definitions/shareAssociation"
							}
						}
					}
				}
			]
		},
		"file_metadata_list": {
			"type": "array",
			"items": {
				"$ref": "#/definitions/file_metadata"
			}
		},
		"base_file_metadata_list": {
			"type": "array",
			"items": {
				"$ref": "#/definitions/base_file_metadata"
			}
		},
		"base_folder_metadata": {
			"required": [
				"name",
				"parentPath",
				"size",
				"version",
				"versionCreated",
				"count",
				"deleted",
				"viewUid",
				"uri"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the folder"
				},
				"parentPath": {
					"type": "string",
					"description": "The name of the folder's parent folder"
				},
				"size": {
					"type": "integer",
					"format": "int64",
					"description": "The size of the folder, in bytes"
				},
				"version": {
					"type": "integer",
					"description": "Folder version.  This number increases when the folder content changes"
				},
				"versionCreated": {
					"type": "string",
					"description": "Creation timestamp for the folder's current version, in ISO-8601 format"
				},
				"count": {
					"type": "integer",
					"description": "The number of items the folder contains"
				},
				"deleted": {
					"type": "boolean",
					"description": "If true, the folder has been logically deleted"
				},
				"viewUid": {
					"type": "array",
					"description": "Array of viewUid",
					"items": {
						"required": [
							"type",
							"viewType",
							"uid"
						],
						"properties": {
							"type": {
								"type": "string",
								"description": "Shared Type"
							},
							"viewType": {
								"type": "string",
								"description": "Type of view"
							},
							"uid": {
								"type": "string",
								"description": "Unique id of view"
							}
						}
					}
				},
				"uri": {
					"type": "string",
					"description": "Unique identifier of the resource"
				}
			}
		},
		"folder_metadata": {
			"allOf": [
				{
					"$ref": "#/definitions/base_folder_metadata"
				},
				{
					"properties": {
						"shareAssociation": {
							"type": "array",
							"description": "Array of shareAssociation",
							"items": {
								"required": [
									"uid",
									"visibility",
									"name",
									"type"
								],
								"properties": {
									"uid": {
										"type": "string",
										"description": "Unique id"
									},
									"visibility": {
										"type": "string",
										"description": "Visibility of share association"
									},
									"name": {
										"type": "string",
										"description": "Name"
									},
									"type": {
										"type": "string",
										"description": "Type of share association"
									}
								}
							}
						}
					}
				}
			]
		},
		"viewUid": {
			"required": [
				"type",
				"viewType",
				"uid"
			],
			"properties": {
				"type": {
					"type": "string",
					"description": "Shared Type"
				},
				"viewType": {
					"type": "string",
					"description": "Type of view"
				},
				"uid": {
					"type": "string",
					"description": "Unique id of view"
				}
			}
		},
		"shareAssociation": {
			"required": [
				"uid",
				"visibility",
				"name",
				"type"
			],
			"properties": {
				"uid": {
					"type": "string",
					"description": "Unique id"
				},
				"visibility": {
					"type": "string",
					"description": "Visibility of share association"
				},
				"name": {
					"type": "string",
					"description": "Name"
				},
				"type": {
					"type": "string",
					"description": "Type of share association"
				}
			}
		},
		"folder_metadata_list": {
			"type": "array",
			"items": {
				"$ref": "#/definitions/folder_metadata"
			}
		},
		"base_folder_metadata_list": {
			"type": "array",
			"items": {
				"$ref": "#/definitions/base_folder_metadata"
			}
		},
		"deleted_list": {
			"required": [
				"path"
			],
			"properties": {
				"path": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "An array of deleted file and folder paths."
				}
			}
		},
		"parent_folder_metadata": {
			"allOf": [
				{
					"$ref": "#/definitions/folder_metadata"
				},
				{
					"properties": {
						"file": {
							"$ref": "#/definitions/file_metadata_list"
						},
						"folder": {
							"$ref": "#/definitions/folder_metadata_list"
						}
					}
				}
			]
		},
		"metadata_response": {
			"properties": {
				"file": {
					"$ref": "#/definitions/file_metadata"
				},
				"folder": {
					"$ref": "#/definitions/parent_folder_metadata"
				}
			}
		},
		"fullview_response": {
			"required": [
				"data"
			],
			"properties": {
				"data": {
					"$ref": "#/definitions/fullview_data"
				}
			}
		},
		"virtualfolder_response": {
			"required": [
				"name",
				"parentPath",
				"size",
				"versionCreated",
				"immutable"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the virtual folder"
				},
				"parentPath": {
					"type": "string",
					"description": "The name of the parent folder"
				},
				"size": {
					"type": "integer",
					"format": "int64",
					"description": "The size of the virtual folder, in bytes"
				},
				"immutable": {
					"type": "boolean",
					"default": false,
					"description": "Whether virtual folder is immutable"
				},
				"versionCreated": {
					"type": "string",
					"description": "Creation timestamp for the virtual folder's current version, in ISO-8601 format"
				}
			}
		},
		"renameVirtualFolderRequest": {
			"required": [
				"src",
				"target"
			],
			"properties": {
				"src": {
					"type": "string",
					"description": "Name of the virtual folder."
				},
				"target": {
					"type": "string",
					"description": "Changed name of the virtual folder."
				}
			}
		},
		"fullview_data": {
			"properties": {
				"file": {
					"$ref": "#/definitions/base_file_metadata_list"
				},
				"folder": {
					"$ref": "#/definitions/base_folder_metadata_list"
				},
				"deleted": {
					"$ref": "#/definitions/deleted_list"
				}
			}
		},
		"trash_response": {
			"required": [
				"count",
				"data"
			],
			"properties": {
				"count": {
					"type": "integer",
					"format": "int64",
					"description": "Total number of search matches"
				},
				"data": {
					"$ref": "#/definitions/trash_data"
				}
			}
		},
		"trash_data": {
			"properties": {
				"file": {
					"$ref": "#/definitions/base_file_metadata_list"
				},
				"folder": {
					"$ref": "#/definitions/base_folder_metadata_list"
				}
			}
		},
		"searchresult_response": {
			"required": [
				"count"
			],
			"properties": {
				"count": {
					"type": "integer",
					"format": "int64",
					"description": "Total number of search matches"
				},
				"file": {
					"$ref": "#/definitions/file_metadata_list"
				},
				"folder": {
					"$ref": "#/definitions/folder_metadata_list"
				}
			}
		},
		"account_response": {
			"required": [
				"usage",
				"id"
			],
			"properties": {
				"id": {
					"type": "string",
					"description": "The user identifier."
				},
				"alias": {
					"type": "string",
					"description": "Username. Available only for MDN accounts."
				},
				"usage": {
					"required": [
						"quota",
						"quotaUsed"
					],
					"properties": {
						"quota": {
							"type": "integer",
							"format": "int64",
							"description": "Total quota space available to the user on the cloud in bytes"
						},
						"quotaUsed": {
							"type": "integer",
							"format": "int64",
							"description": "Total quota space used in bytes"
						}
					}
				}
			}
		},
		"playlist": {
			"required": [
				"uid",
				"name",
				"type",
				"mimeTypeRegex",
				"creationDate",
				"lastModifiedDate",
				"uri"
			],
			"properties": {
				"uid": {
					"type": "string",
					"description": "The uid of the playlist"
				},
				"name": {
					"type": "string",
					"description": "The name of the playlist"
				},
				"type": {
					"type": "string",
					"description": "The type of playlist"
				},
				"mimeTypeRegex": {
					"type": "string",
					"description": "Regex pattern for playlist"
				},
				"paths": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "Array of paths"
				},
				"creationDate": {
					"type": "string",
					"description": "Timestamp for creation date of playlist"
				},
				"lastModifiedDate": {
					"type": "string",
					"description": "Timestamp for last modified date of playlist"
				},
				"uri": {
					"type": "string",
					"description": "Unique identifier of the resource"
				},
				"shareAssociation": {
					"type": "array",
					"description": "Array of shareAssociation",
					"items": {
						"$ref": "#/definitions/shareAssociation"
					}
				}
			}
		},
		"playlist_item": {
			"required": [
				"filename",
				"path",
				"mimeType",
				"size",
				"versionCreated",
				"fileAttribute",
				"contentToken",
				"checksum",
				"contentAccessible",
				"extension",
				"tags",
				"uri"
			],
			"properties": {
				"filename": {
					"type": "string",
					"description": "Name of the file"
				},
				"path": {
					"type": "string",
					"description": "Path of the file"
				},
				"mimeType": {
					"type": "string",
					"description": "Type of content"
				},
				"size": {
					"type": "integer",
					"description": "Size of the item"
				},
				"versionCreated": {
					"type": "string",
					"description": "Timestamp of version created date"
				},
				"fileAttribute": {
					"$ref": "#/definitions/playlist_item"
				},
				"contentToken": {
					"type": "string",
					"description": "Unique token for content"
				},
				"checksum": {
					"type": "string",
					"description": "Checksum detail"
				},
				"contentAccessible": {
					"type": "boolean",
					"description": "Show accessibility of the content"
				},
				"extension": {
					"type": "string",
					"description": "File extension"
				},
				"tags": {
					"type": "object"
				},
				"uri": {
					"type": "string",
					"description": "Unique identifier of the resource"
				}
			}
		},
		"playlist_add_request": {
			"required": [
				"add"
			],
			"properties": {
				"add": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "An array of paths to items."
				}
			}
		},
		"restore_trash_request": {
			"required": [
				"path"
			],
			"properties": {
				"path": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "An array of paths of trashed items."
				}
			}
		},
		"updateTags_request": {
			"required": [
				"uri",
				"Tags"
			],
			"properties": {
				"uri": {
					"type": "string",
					"description": "URI of the resource. This is a URI value obtained from a fullview or metadata response"
				},
				"Tags": {
					"type": "string",
					"description": "A set of Tags"
				},
				"createVersion": {
					"type": "boolean",
					"description": "If 'true', creates a new version of the file or folder. Defaults to 'false'.",
					"default": false
				}
			}
		},
		"flashback_request": {
			"required": [
				"files"
			],
			"properties": {
				"files": {
					"type": "array",
					"items": {
						"$ref": "#/definitions/image_flashback_response"
					},
					"description": "An array of paths to items."
				}
			}
		},
		"updateFavorite_request": {
			"required": [
				"uri"
			],
			"properties": {
				"uri": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "URI of the resource. This is a URI value obtained from a fullview or metadata response"
				},
				"createVersion": {
					"type": "boolean",
					"description": "If 'true', creates a new version of the file or folder. Defaults to 'false'.",
					"default": false
				}
			}
		},
		"playlist_add_response": {
			"required": [
				"paths"
			],
			"properties": {
				"paths": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "List of paths"
				}
			}
		},
		"playlist_request": {
			"required": [
				"name",
				"type",
				"paths"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "Name of the playlist."
				},
				"paths": {
					"type": "array",
					"items": {
						"type": "string"
					},
					"description": "An array of paths to items."
				},
				"type": {
					"type": "string",
					"description": "The type of the playlist. Can be one of 'image', 'music', 'video' or 'image-video'"
				}
			}
		},
		"playlist_base": {
			"required": [
				"name",
				"type"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the playlist"
				},
				"type": {
					"type": "string",
					"description": "The type of the playlist. Can be one of 'image', 'music', 'video' or 'image-video'"
				}
			}
		},
		"folder_request": {
			"required": [
				"name",
				"path",
				"override"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "Folder name to be created."
				},
				"path": {
					"type": "string",
					"description": "Path where the folder has to be created."
				},
				"override": {
					"type": "string",
					"description": "Specifies what happens if a folder of the same name exists at the target path. Set to 'overwrite' to overwrite the existing folder. Set to 'modify' to treat the new folder as a modification of the old folder. If the 'override' parameter is not set, the following algorithm is applied if the existing folder has a 'deleted' attribute set to 'true', the folder is overwritten; if the old folder's 'deleted' attribute is false or not set, the folder is modified."
				}
			}
		},
		"fops_copy_request": {
			"required": [
				"src",
				"target",
				"safe",
				"conflictsolve",
				"override"
			],
			"properties": {
				"src": {
					"type": "string",
					"description": "Full path of the file/folder for copy/move/rename operations."
				},
				"target": {
					"type": "string",
					"description": "Full path of the target file/folder for copy/move/rename operations. In case of files the full/changed name should be included in the target."
				},
				"safe": {
					"type": "boolean",
					"default": false,
					"description": "If 'true', ensures that name conflicts are resolved according to the value of the 'conflictsolve' parameter. Defaults to 'false', in which case the operation will overwrite an existing file/folder of the same name."
				},
				"conflictsolve": {
					"type": "string",
					"description": "Defines how name conflicts are resolved, if the 'safe' parameter is set to 'true'. If set to 'copy', a new file is written to the destination folder with a non-conflicting name. If not set, the operation is rolled back and operation returns '409 Conflict'."
				},
				"override": {
					"type": "string",
					"description": "Specifies what happens if a file of the same name exists at the target path and the 'safe' parameter is not set. Set to 'overwrite' to treat the copied file as completely new. Set to 'modify' to treat the new file as a modification of the old one. If the 'override' parameter is not set, the following algorithm is used: if the existing file has a 'deleted' attribute set to 'true', the file is overwritten; if the old file's 'deleted' attribute is false or not set, the file is modified."
				}
			}
		},
		"metadata_update_request": {
			"required": [
				"name",
				"value",
				"uri"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the system attribute to be updated"
				},
				"value": {
					"type": "string",
					"description": "The value of the system attribute"
				},
				"uri": {
					"type": "string",
					"description": "The URI to the file which needs to be updated"
				}
			}
		},
		"fops_change_request": {
			"required": [
				"src",
				"target",
				"safe",
				"conflictsolve"
			],
			"properties": {
				"src": {
					"type": "string",
					"description": "Full path of the file/folder for copy/move/rename operations."
				},
				"target": {
					"type": "string",
					"description": "Full path of the target file/folder for copy/move/rename operations. In case of files the full/changed name should be included in the target."
				},
				"safe": {
					"type": "boolean",
					"default": false,
					"description": "If 'true', ensures that name conflicts are resolved according to the value of the 'conflictsolve' parameter. Defaults to 'false', in which case the operation will overwrite an existing file/folder of the same name."
				},
				"conflictsolve": {
					"type": "string",
					"description": "Defines how name conflicts are resolved, if the 'safe' parameter is set to 'true'. If set to 'copy', a new file is written to the destination folder with a non-conflicting name. If not set, the operation is rolled back and operation returns '409 Conflict'."
				}
			}
		},
		"contacts": {
			"required": [
				"contactsResponse"
			],
			"properties": {
				"contactsResponse": {
					"$ref": "#/definitions/contacts_response"
				}
			}
		},
		"contacts_response": {
			"required": [
				"account"
			],
			"properties": {
				"account": {
					"$ref": "#/definitions/contacts_account"
				}
			}
		},
		"contacts_account": {
			"required": [
				"userid",
				"addrbook"
			],
			"properties": {
				"userid": {
					"type": "string",
					"description": "Unique identifier for the current user"
				},
				"addrbook": {
					"$ref": "#/definitions/contacts_addrbook"
				}
			}
		},
		"contacts_addrbook": {
			"required": [
				"updated",
				"contacts"
			],
			"properties": {
				"updated": {
					"type": "string",
					"description": "Timestamp of latest update"
				},
				"contacts": {
					"$ref": "#/definitions/contacts_contacts"
				}
			}
		},
		"contacts_contacts": {
			"required": [
				"itemcount",
				"contact"
			],
			"properties": {
				"itemcount": {
					"type": "integer",
					"description": "Number of contacts"
				},
				"contact": {
					"type": "array",
					"description": "Array of contacts",
					"items": {
						"$ref": "#/definitions/contact"
					}
				}
			}
		},
		"contact_request": {
			"required": [
				"version"
			],
			"properties": {
				"firstname": {
					"type": "string",
					"description": "Contact's given name"
				},
				"lastname": {
					"type": "string",
					"description": "Contact's surname"
				},
				"middlename": {
					"type": "string",
					"description": "Contact's middle name"
				},
				"nameprefix": {
					"type": "string",
					"description": "Contact's name prefix"
				},
				"namesuffix": {
					"type": "string",
					"description": "Contact's name suffix"
				},
				"nickname": {
					"type": "string",
					"description": "Contacts's nickname"
				},
				"birthday": {
					"type": "string",
					"description": "Contacts's birth date in the format YYYY-MM-DD"
				},
				"anniversary": {
					"type": "string",
					"description": "Contacts's anniversary date in the format YYYY-MM-DD"
				},
				"spouse": {
					"type": "string",
					"description": "Contacts's spouse name"
				},
				"children": {
					"type": "string",
					"description": "Contacts's children names"
				},
				"orgname": {
					"type": "string",
					"description": "Contacts's company name"
				},
				"orgunit": {
					"type": "string",
					"description": "Contacts's company department"
				},
				"jobtitle": {
					"type": "string",
					"description": "Contacts's job titile"
				},
				"profession": {
					"type": "string",
					"description": "Contacts's profession"
				},
				"assistant": {
					"type": "string",
					"description": "Contacts's assistant name"
				},
				"gender": {
					"type": "string",
					"description": "Contacts's gender. Can have a value as M(ale), F(emale) or U(ndefined)"
				},
				"relationship": {
					"type": "string",
					"description": "Contacts's relationship with the person"
				},
				"maritalstatus": {
					"type": "string",
					"description": "Contacts's marital status"
				},
				"source": {
					"type": "string",
					"description": "Origin of the contact"
				},
				"note": {
					"type": "string",
					"description": "Arbitrary text associated with this contact"
				},
				"incaseofemergency": {
					"type": "boolean",
					"description": "Marked true for emergency contacts. Maximum 3 contacts can be defined as incaseofemergency.",
					"default": false
				},
				"favorite": {
					"type": "boolean",
					"description": "Marked true for favorite contacts",
					"default": false
				},
				"tel": {
					"type": "array",
					"description": "List of contact's telephone numbers",
					"items": {
						"$ref": "#/definitions/contacts_tel"
					}
				},
				"email": {
					"type": "array",
					"description": "List of contact's email addresses",
					"items": {
						"$ref": "#/definitions/contacts_email"
					}
				},
				"address": {
					"type": "array",
					"description": "List of contact's addresses",
					"items": {
						"$ref": "#/definitions/contacts_address"
					}
				},
				"im": {
					"type": "array",
					"description": "List of contact's IM addresses",
					"items": {
						"$ref": "#/definitions/contacts_im"
					}
				},
				"version": {
					"type": "integer",
					"description": "The current version of the contact."
				}
			}
		},
		"contact_create_request": {
			"properties": {
				"firstname": {
					"type": "string",
					"description": "Contact's given name"
				},
				"lastname": {
					"type": "string",
					"description": "Contact's surname"
				},
				"middlename": {
					"type": "string",
					"description": "Contact's middle name"
				},
				"nameprefix": {
					"type": "string",
					"description": "Contact's name prefix"
				},
				"namesuffix": {
					"type": "string",
					"description": "Contact's name suffix"
				},
				"nickname": {
					"type": "string",
					"description": "Contacts's nickname"
				},
				"birthday": {
					"type": "string",
					"description": "Contacts's birth date in the format YYYY-MM-DD"
				},
				"anniversary": {
					"type": "string",
					"description": "Contacts's anniversary date in the format YYYY-MM-DD"
				},
				"spouse": {
					"type": "string",
					"description": "Contacts's spouse name"
				},
				"children": {
					"type": "string",
					"description": "Contacts's children names"
				},
				"orgname": {
					"type": "string",
					"description": "Contacts's company name"
				},
				"orgunit": {
					"type": "string",
					"description": "Contacts's company department"
				},
				"jobtitle": {
					"type": "string",
					"description": "Contacts's job titile"
				},
				"profession": {
					"type": "string",
					"description": "Contacts's profession"
				},
				"assistant": {
					"type": "string",
					"description": "Contacts's assistant name"
				},
				"gender": {
					"type": "string",
					"description": "Contacts's gender. Can have a value as M(ale), F(emale) or U(ndefined)"
				},
				"relationship": {
					"type": "string",
					"description": "Contacts's relationship with the person"
				},
				"maritalstatus": {
					"type": "string",
					"description": "Contacts's marital status"
				},
				"source": {
					"type": "string",
					"description": "Origin of the contact"
				},
				"note": {
					"type": "string",
					"description": "Arbitrary text associated with this contact"
				},
				"incaseofemergency": {
					"type": "boolean",
					"description": "Marked true for emergency contacts. Maximum 3 contacts can be defined as incaseofemergency.",
					"default": false
				},
				"favorite": {
					"type": "boolean",
					"description": "Marked true for favorite contacts",
					"default": false
				},
				"tel": {
					"type": "array",
					"description": "List of contact's telephone numbers",
					"items": {
						"$ref": "#/definitions/contacts_tel"
					}
				},
				"email": {
					"type": "array",
					"description": "List of contact's email addresses",
					"items": {
						"$ref": "#/definitions/contacts_email"
					}
				},
				"address": {
					"type": "array",
					"description": "List of contact's addresses",
					"items": {
						"$ref": "#/definitions/contacts_address"
					}
				},
				"im": {
					"type": "array",
					"description": "List of contact's IM addresses",
					"items": {
						"$ref": "#/definitions/contacts_im"
					}
				}
			}
		},
		"contact": {
			"properties": {
				"firstname": {
					"type": "string",
					"description": "Contact's given name"
				},
				"lastname": {
					"type": "string",
					"description": "Contact's surname"
				},
				"middlename": {
					"type": "string",
					"description": "Contact's middle name"
				},
				"nameprefix": {
					"type": "string",
					"description": "Contact's name prefix"
				},
				"namesuffix": {
					"type": "string",
					"description": "Contact's name suffix"
				},
				"nickname": {
					"type": "string",
					"description": "Contacts's nickname"
				},
				"birthday": {
					"type": "string",
					"description": "Contacts's birth date"
				},
				"anniversary": {
					"type": "string",
					"description": "Contacts's anniversary date"
				},
				"spouse": {
					"type": "string",
					"description": "Contacts's spouse name"
				},
				"children": {
					"type": "string",
					"description": "Contacts's children names"
				},
				"orgname": {
					"type": "string",
					"description": "Contacts's company name"
				},
				"orgunit": {
					"type": "string",
					"description": "Contacts's company department"
				},
				"jobtitle": {
					"type": "string",
					"description": "Contacts's job titile"
				},
				"profession": {
					"type": "string",
					"description": "Contacts's profession"
				},
				"assistant": {
					"type": "string",
					"description": "Contacts's assistant name"
				},
				"gender": {
					"type": "string",
					"description": "Contacts's gender. Can have a value as M(ale), F(emale) or U(ndefined)"
				},
				"relationship": {
					"type": "string",
					"description": "Contacts's relationship with the person"
				},
				"maritalstatus": {
					"type": "string",
					"description": "Contacts's marital status"
				},
				"source": {
					"type": "string",
					"description": "Origin of the contact"
				},
				"note": {
					"type": "string",
					"description": "Arbitrary text associated with this contact"
				},
				"created": {
					"type": "string",
					"description": "Timestamp the contact was created"
				},
				"modified": {
					"type": "string",
					"description": "Timestamp the contact was last updated"
				},
				"incaseofemergency": {
					"type": "boolean",
					"description": "Marked true for emergency contacts. Maximum 3 contacts can be defined as incaseofemergency.",
					"default": false
				},
				"favorite": {
					"type": "boolean",
					"description": "Marked true for favorite contacts",
					"default": false
				},
				"tel": {
					"type": "array",
					"description": "List of contact's telephone numbers",
					"items": {
						"$ref": "#/definitions/contacts_tel"
					}
				},
				"email": {
					"type": "array",
					"description": "List of contact's email addresses",
					"items": {
						"$ref": "#/definitions/contacts_email"
					}
				},
				"address": {
					"type": "array",
					"description": "List of contact's addresses",
					"items": {
						"$ref": "#/definitions/contacts_address"
					}
				},
				"im": {
					"type": "array",
					"description": "List of contact's IM addresses",
					"items": {
						"$ref": "#/definitions/contacts_im"
					}
				},
				"version": {
					"type": "integer",
					"description": "Contact version.  This number increases when the contact is updated"
				},
				"id": {
					"type": "string",
					"description": "Unique identifier for this contact"
				}
			}
		},
		"contacts_tel": {
			"required": [
				"type",
				"indx",
				"number",
				"preference"
			],
			"properties": {
				"type": {
					"type": "string",
					"description": "Type of telephone number, i.e., 'assistant', 'businessfax', 'business', 'callback', 'car', 'companymain', 'homefax', 'home', 'mobile', 'otherfax', 'pager', 'primaryfax', 'primary', 'radio', 'school', 'telex', 'ttydd', 'videophone', 'voipphone', 'other'"
				},
				"indx": {
					"type": "integer",
					"description": "When combined with 'type', provides a unique identifier for the entry"
				},
				"number": {
					"type": "string",
					"description": "Telephone number"
				},
				"preference": {
					"type": "integer",
					"description": "When sorting, lower numbers indicate a higher preference. The value must be less than 100."
				}
			}
		},
		"contacts_email": {
			"required": [
				"type",
				"indx",
				"address",
				"preference"
			],
			"properties": {
				"type": {
					"type": "string",
					"description": "Type of email address, i.e., 'business', 'personal', 'other'."
				},
				"indx": {
					"type": "integer",
					"description": "When combined with 'type', provides a unique identifier for the entry"
				},
				"address": {
					"type": "string",
					"description": "Email address"
				},
				"preference": {
					"type": "integer",
					"description": "For sorting. Lower numbers indicate a higher preference. The value must be less than 100."
				}
			}
		},
		"contacts_address": {
			"required": [
				"type",
				"indx",
				"preference"
			],
			"properties": {
				"type": {
					"type": "string",
					"description": "Type of address, i.e., 'home', 'business', 'personal', 'primary', 'other'"
				},
				"indx": {
					"type": "integer",
					"description": "When combined with 'type', provides a unique identifier for the entry"
				},
				"pobox": {
					"type": "string"
				},
				"street": {
					"type": "string"
				},
				"apartment": {
					"type": "string"
				},
				"city": {
					"type": "string"
				},
				"state": {
					"type": "string"
				},
				"zipcode": {
					"type": "string"
				},
				"country": {
					"type": "string"
				},
				"preference": {
					"type": "integer",
					"description": "For sorting. Lower numbers indicate a higher preference. The value must be less than 100."
				}
			}
		},
		"contacts_im": {
			"required": [
				"address",
				"preference",
				"type"
			],
			"properties": {
				"type": {
					"type": "string",
					"description": "Type of address, i.e., 'aim', 'icq', 'yahoo', 'google', 'skype', 'jabber', 'msn', 'other'"
				},
				"address": {
					"type": "string",
					"description": "IM contact string"
				},
				"preference": {
					"type": "integer",
					"description": "For sorting. Lower numbers indicate a higher preference. The value must be less than 100."
				}
			}
		},
		"createShare_request": {
			"required": [
				"resources"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the share."
				},
				"resources": {
					"type": "array",
					"items": {
						"$ref": "#/definitions/resource_request"
					},
					"description": "An array of resource request object."
				},
				"expiresIn": {
					"type": "integer",
					"description": "The time to live of the share in seconds. The value 0 signifies the share will never expire. Minimum value is 300. If not provided, defaults to 86400."
				}
			}
		},
		"share_response_list": {
			"properties": {
				"count": {
					"type": "integer",
					"description": "The total number of shares"
				},
				"links": {
					"type": "array",
					"items": {
						"$ref": "#/definitions/link_response"
					}
				},
				"share": {
					"type": "array",
					"items": {
						"$ref": "#/definitions/share_response"
					}
				}
			}
		},
		"link_response": {
			"required": [
				"rel",
				"link"
			],
			"properties": {
				"rel": {
					"type": "string",
					"description": "The link identifier."
				},
				"link": {
					"type": "string",
					"description": "The URI of the link."
				}
			}
		},
		"share_response": {
			"required": [
				"name"
			],
			"properties": {
				"links": {
					"type": "array",
					"items": {
						"required": [
							"rel",
							"link"
						],
						"properties": {
							"rel": {
								"type": "string",
								"description": "The link identifier."
							},
							"link": {
								"type": "string",
								"description": "The URI of the link."
							}
						}
					}
				},
				"uid": {
					"type": "string",
					"description": "The resource identifier."
				},
				"name": {
					"type": "string",
					"description": "The name of the share."
				},
				"owner": {
					"description": "The owner of the share"
				},
				"sharer": {
					"description": "The sharer of the share"
				},
				"totalResourceCount": {
					"type": "integer",
					"description": "The total count of shared resources."
				},
				"expiresIn": {
					"type": "integer",
					"description": "The time to live of the share in seconds."
				},
				"expirationDate": {
					"type": "string",
					"description": "Expiration date on the share."
				},
				"creationDate": {
					"type": "string",
					"description": "The date and time the share was created."
				},
				"lastModifiedDate": {
					"type": "string",
					"description": "The date and time the share was last modified from the perspective of the owner."
				},
				"inboundLastModifiedDate": {
					"type": "string",
					"description": "The date and time the share was last modified from the perspective of a member."
				},
				"publicInviteKey": {
					"type": "string",
					"description": "The invite key of a public share."
				},
				"resources": {
					"type": "array",
					"description": "Array of resources",
					"items": {
						"required": [
							"name",
							"type"
						],
						"properties": {
							"uid": {
								"type": "string",
								"description": "The resource identifier."
							},
							"name": {
								"type": "string",
								"description": "Name of the resource."
							},
							"type": {
								"type": "string",
								"description": "Type of the resource."
							},
							"subType": {
								"type": "string",
								"description": "SubType of the resource."
							},
							"location": {
								"type": "string",
								"description": "Location of the resource."
							},
							"url": {
								"type": "string",
								"description": "Direct download link for the resource. Applicable for file resources only."
							},
							"size": {
								"type": "integer",
								"description": "Size of the resource."
							},
							"resourceId": {
								"type": "string",
								"description": "Id of the resource."
							},
							"contentToken": {
								"type": "string",
								"description": "ContentToken of the resource."
							},
							"checksum": {
								"type": "string",
								"description": "Checksum of the resource."
							},
							"lastModifiedDate": {
								"type": "string",
								"description": "LastModifiedDate of the resource."
							}
						}
					}
				}
			}
		},
		"createShare_response": {
			"allOf": [
				{
					"$ref": "#/definitions/share_response"
				}
			]
		},
		"resource_request": {
			"required": [
				"name",
				"location"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "Name of the resource."
				},
				"type": {
					"type": "string",
					"description": "Type of the resource: file/folder/playlist"
				},
				"subType": {
					"type": "string",
					"description": "(Optional) subtype of the resource: image/video/audio.  Used to aid playback of the file when viewed in a browser"
				},
				"location": {
					"type": "string",
					"description": "Location of the resource. This is a URI value obtained from a fullview, metadata, or playlist response"
				},
				"size": {
					"type": "integer",
					"description": "Size of the resource. Mandatory in case of file share only."
				}
			}
		},
		"resource_response": {
			"required": [
				"name",
				"type"
			],
			"properties": {
				"uid": {
					"type": "string",
					"description": "The resource identifier."
				},
				"name": {
					"type": "string",
					"description": "Name of the resource."
				},
				"type": {
					"type": "string",
					"description": "Type of the resource."
				},
				"subType": {
					"type": "string",
					"description": "SubType of the resource."
				},
				"location": {
					"type": "string",
					"description": "Location of the resource."
				},
				"url": {
					"type": "string",
					"description": "Direct download link for the resource. Applicable for file resources only."
				},
				"size": {
					"type": "integer",
					"description": "Size of the resource."
				},
				"resourceId": {
					"type": "string",
					"description": "Id of the resource."
				},
				"contentToken": {
					"type": "string",
					"description": "ContentToken of the resource."
				},
				"checksum": {
					"type": "string",
					"description": "Checksum of the resource."
				},
				"lastModifiedDate": {
					"type": "string",
					"description": "LastModifiedDate of the resource."
				}
			}
		},
		"uploadurls": {
			"required": [
				"uploadurl"
			],
			"properties": {
				"uploadurl": {
					"type": "string",
					"description": "The upload url with the uploadid to upload the binary content of the file."
				},
				"commiturl": {
					"type": "string",
					"description": "The commit url to create the file after binary content is uploaded in chunks."
				}
			}
		},
		"error_response": {
			"required": [
				"error_code",
				"error_description"
			],
			"properties": {
				"error_code": {
					"type": "string",
					"description": "A unique code identifying the error"
				},
				"error_description": {
					"type": "string",
					"description": "A detailed description of the error"
				}
			}
		},
		"tags_response": {
			"required": [
				"Tags"
			],
			"properties": {
				"Tags": {
					"type": "string",
					"description": "A set of Tags"
				}
			}
		},
		"flashback_response": {
			"required": [
				"latest"
			],
			"properties": {
				"latest": {
					"description": "The latest captured image having image score",
					"$ref": "#/definitions/image_flashback_response"
				},
				"flashback": {
					"description": "A set of images for each time frame",
					"$ref": "#/definitions/flashback_list"
				}
			}
		},
		"flashback_list": {
			"properties": {
				"<year>": {
					"type": "array",
					"items": {
						"$ref": "#/definitions/image_flashback_response"
					}
				}
			}
		},
		"image_flashback_response": {
			"required": [
				"name",
				"parentPath",
				"systemAttributes"
			],
			"properties": {
				"name": {
					"type": "string",
					"description": "The name of the file"
				},
				"parentPath": {
					"type": "string",
					"description": "The folder where the file is located"
				},
				"systemAttributes": {
					"description": "A set of file attributes.  The attribute set will vary depending on file type"
				}
			}
		}
	},
	"securityDefinitions": {
		"files_auth": {
			"type": "oauth2",
			"flow": "accessCode",
			"authorizationUrl": "https://api.cloudapi.verizon.com/cloud/1/oauth2/authorize",
			"tokenUrl": "https://api.cloudapi.verizon.com/cloud/1/oauth2/token",
			"scopes": {
				"full_access": "I agree to allow this website to access my application account to try out the API."
			}
		}
	}
}

Copyright © 2015-2017, Verizon and/or its Licensors. All rights reserved.