Start or Stop Manual Recording by Accessory Id

This API call allows starting, stopping or checking status for manual recordings. If start-recording is invoked a new ActivityActivity - An event that is represented by a start time, end time, relevance and other meta-data. Activities are used to represent videos or audio activity that is part of the same sequence of frames or content. Every Activity has a unique Activity Id. Activities will only be stored for as long your service plan dictates. An Activity belongs to an Accessory. For the full list of attributes on an Activity see Get Activity by Id. Activities can be referred to as "clips" or "recordings" in the Logi Circle application. is automatically created. If a duration isn't passed to start-recording, then 30 seconds will be used. Notification Events will appear for new requested recordings. The newly created ActivityActivity - An event that is represented by a start time, end time, relevance and other meta-data. Activities are used to represent videos or audio activity that is part of the same sequence of frames or content. Every Activity has a unique Activity Id. Activities will only be stored for as long your service plan dictates. An Activity belongs to an Accessory. For the full list of attributes on an Activity see Get Activity by Id. Activities can be referred to as "clips" or "recordings" in the Logi Circle application. may not appear in Get Activity by Id or Get Activities by Accessory Id for a little while after creation due to processing time.

Permissions

Requires a Permissions scope of: circle:accessories or circle:activities_basic

Response Body

Main Object

Name

Type

Description

status

string

One of:

recording - A manual recording via this API call is currently in progress
none - No manual recording is in progress

context

object

Contains a StartRecordingContext, StopRecordingConext or StatusRecordingContext object depending on type requested.

StartRecordingContext Sub-Object

Name

Type

Description

activityId

string

The new Activity IdActivity Id - A unique non changing value to identify a particular Activity within an Accessory event stream. The API uses a short ISO8601 based timestamp format (YYYYMMDDTHHMMSSZ) with everything represented server side as UTC+0 or "zulu" format. Activity Id's are the short Timestamp of the initial time of Activity creation. However, the Activities startTime value may be later than the value represented by the Activity Id due to trimming and video processing. Activity Id's are not globally unique, but are unique for a given Accessory Id. that will be used. Follow progress via Notification Events.

previousStatus

string

The status that was previously in use. Can be used to determine if caller changed actual current status.

StopRecordingContext Sub-Object

Name

Type

Description

previousStatus

string

The status that was previously in use. Can be used to determine if caller changed actual current status.

StatusRecordingContext Sub-Object

activityId

string

The current Activity IdActivity Id - A unique non changing value to identify a particular Activity within an Accessory event stream. The API uses a short ISO8601 based timestamp format (YYYYMMDDTHHMMSSZ) with everything represented server side as UTC+0 or "zulu" format. Activity Id's are the short Timestamp of the initial time of Activity creation. However, the Activities startTime value may be later than the value represented by the Activity Id due to trimming and video processing. Activity Id's are not globally unique, but are unique for a given Accessory Id. being recorded. Empty string if none.

duration

integer

Length of time in seconds to record.

durationRemaining

integer

Length of time in seconds left to record.

source

string

The Activity Set
based source attribute from the start-recording request.

Language
Authentication
OAuth2