Roundscribe session API
1. Authenticate
Ask a Roundscribe administrator to create a key under Administration → API access with the Query and download permission. Supply it through the agent’s secret store as ROUNDSCRIBE_API_KEY. Send Authorization: Bearer <key> on every API request. Keep the key out of URLs, prompts, and logs.
2. Find the session
Call GET /roundscribe/api/v1/sessions with staff, from, and to. Both dates are inclusive UTC session-start dates. The staff filter matches case-insensitive substrings. This PowerShell example collects exact-name matches across all pages, including empty pages that have a next link.
$site = 'https://client.securegreen.co'
$staff = 'Alex Morgan'
$from = '2026-11-01'
$to = '2026-11-14'
if (!$env:ROUNDSCRIBE_API_KEY) { throw 'Set ROUNDSCRIBE_API_KEY first.' }
$headers = @{ Authorization = 'Bearer ' + $env:ROUNDSCRIBE_API_KEY }
$name = [uri]::EscapeDataString($staff)
$next = "/roundscribe/api/v1/sessions?staff=$name&from=$from&to=$to"
$matchesFound = @(while ($next) {
$page = Invoke-RestMethod -Uri ($site + $next) -Headers $headers -ErrorAction Stop
$page.items | Where-Object { $_.staffName -ieq $staff }
$next = $page.next
})
$matchesFound | Select-Object id, startedUtc, staffName, workstation, source
3. Download the selected ZIP
If no sessions match, report that result. If several match, use the requested start time or workstation to identify the session, or ask which ID to use. Set $id to the chosen ID and run this in the same PowerShell session.
$id = 'PASTE_SELECTED_SESSION_ID'
$session = $matchesFound | Where-Object { $_.id -eq $id }
if (!$session) { throw 'Choose an ID from the search results.' }
if (!$session.download) { throw 'This key needs Query and download permission.' }
Invoke-WebRequest -UseBasicParsing -Uri ($site + $session.download) -Headers $headers -OutFile "$id.zip" -ErrorAction Stop
The ZIP contains the session audio, available screenshots, and metadata.json with the timeline and screenshot timeframes. HTTP 401 means the key is missing, invalid, expired, or revoked. HTTP 403 on download means the key lacks download permission.
Manage API keys