Sign in

v48

latestOpenAPI 3.0.0raw.githubusercontent.com2025-12-0297180624.8 KB
UI Action

Extract rewind recording

Rewind and capture the device's background screen recording from a specified time period.

post/boxes/{boxId}/actions/recording/rewind/extract

Path parameters

boxIdstring required
Example:c9bdc193-b54b-4ddb-a035-5ac0c598d32d

Box ID

Request body

durationstring

How far back in time to rewind for extracting recorded video. This specifies the duration to go back from the current moment (e.g., '30s' rewinds 30 seconds to get recent recorded activity). Default is 30s, max is 5m.

Supported time units: ms (milliseconds), s (seconds), m (minutes), h (hours) Example formats: "500ms", "30s", "5m", "1h" Maximum allowed: 5m

Example request

{
  "duration": "10s"
}

Response

storageKeystring required

Storage key of the recording. Before the box is deleted, you can use this storageKey with the endpoint box/:boxId/storage/presigned-url to get a downloadable URL for the recording.

presignedUrlstring required

Presigned URL of the recording. This is a temporary downloadable URL with an expiration time for accessing the recording file.

Example response

{
  "storageKey": "storage://gbox/recording/1234567890",
  "presignedUrl": "https://gbox.ai/api/v1/boxes/1234567890/recording/1234567890"
}