Get Summary by ID

Retrieve the metadata details for a specific Summary ID.

Get the current status and meta-data details for a SummarySummary - A video clip that is comprised of one or more Activities with filler data placed between them. Summaries are generated via API calls and have numerous options which govern their creation. A summary is referred to as a "Day Brief" in the Logi Circle application.. Do not use this call to poll the creation state of a Summary, instead listen for the summary_created Notification Event. A Summary is only kept on the server for a short time after it has been created. If it has been purged, a 404 error will result.

To create a Summary use Create Sumary.

To access a Summaries content, use Get Summary DASHGet Summary HLS or Get Summary MP4 File. You can only access a summary if the state is processed and summaryResult is true.

Permissions

Requires the Permissions scope of circle:summaries

Response Body Params

The GET call here, returns the below bare wrapped inside a JSON object with a key called summary

{
  "summary": {
    // Bare Object Contents here
  }

The Bare JSON Object contains the following members:

Name

Type

Description

summaryId

string

The SummarySummary - A video clip that is comprised of one or more Activities with filler data placed between them. Summaries are generated via API calls and have numerous options which govern their creation. A summary is referred to as a "Day Brief" in the Logi Circle application. ID

accessoryId

string

The Accessory IdAccessory Id - A unique non changing value to identify a particular Accessory. Accessory Id's are globally unique and are UUID v4 strings. A new Accessory Id is assigned by the servers when a device is associated to an account for the first time. If the same physical device is re-associated to the same account, it will receive the same Accessory Id again. If the same physical device is re-associated to a different account, it will receive a new Accessory Id. Example: 70e3e6f9-70c3-45b2-62e4-ace3d027988a this summary belongs too.

state

string

Current state of the summary processing. One of:

created - The request has been created, but it is not yet queued
processable - The request has been queued.
processing - The request is currently being serviced.
processed - The request has been finished. Check the summaryResult field to see if it was ok.

summaryResult

boolean

true if this summary has finished processing correctly. If the state is processed and this value is false then the Summary was unable to be created. See summaryError field for info.

summaryError

string

If the summary was unable to be created, one of the following errors may be returned:

<empty string> - No error occured
ContentNotFound - No Activity or time-lapse content was found; or not enough content was found; for the requested period.
<All other values> - An internal error occurred.

created

string

The TimestampTimestamp - An ISO8601 based format with everything represented server side as UTC+0 or "zulu" format. Takes the form of YYYY-MM-DDTHH:MM:SSZ - For example: 2015-04-04T00:43:29Z or 2016-05-28T23:12:59Z or 2016-11-04T12:00:00Z when Create Sumary was called.

startTime

string

The TimestampTimestamp - An ISO8601 based format with everything represented server side as UTC+0 or "zulu" format. Takes the form of YYYY-MM-DDTHH:MM:SSZ - For example: 2015-04-04T00:43:29Z or 2016-05-28T23:12:59Z or 2016-11-04T12:00:00Z of the first video frame within the Summary itself.

endTime

string

The TimestampTimestamp - An ISO8601 based format with everything represented server side as UTC+0 or "zulu" format. Takes the form of YYYY-MM-DDTHH:MM:SSZ - For example: 2015-04-04T00:43:29Z or 2016-05-28T23:12:59Z or 2016-11-04T12:00:00Z of the last video frame within the Summary itself.

playbackDuration

integer

The number of milliseconds the resulting content is. This may be less than or equal to the value requested if not enough content was found to fill the requested length. 0 in all error or in progress states.

Language
Authentication
OAuth2