Starts a cloud archive recording for the given camera and time range. timestamp is the start in Unix epoch milliseconds and duration is in seconds. The range must start at or before the current time and end no more than 5 seconds after it, which allows for a small difference between the client and server clocks. A range that starts in the future, or ends more than 5 seconds after the current time, is rejected and no archive is created. The response includes a durable archiveId and a sessionId. Poll GET /v3/archives/org/{orgId}/{archiveId} (preferred) or GET /v3/archives/org/{orgId}/session/{sessionId} until status is COMPLETED or FAILED. When COMPLETED, that GET response includes download URLs in files.
Required scope: write:archives
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400Invalid parameters, or the time range starts in the future or ends more than 5 seconds after the current time.
404Camera not found.
500Archive was created but its ID could not be resolved.
