Get a session audio download URL

Returns a temporary URL for the joined session audio. Requires the torqee:audio:read scope.

GET/api/v1/sessions/{id}/audio-url

Authorization

AuthorizationOAuth2 access token · headerrequired

OAuth 2.1 authorization code flow with PKCE. Audience must be the connect URL.

Scopes:torqee:audio:read

AuthorizationBearer token · headerrequired

Workspace API key issued from the torqee web app. Pass the torqee_-prefixed key as the bearer token. API keys carry the same read scopes as OAuth tokens.

Path parameters

idstringrequired

Responses

200

Temporary session audio download URL

urlstring<uri>required

expiresAtstring<date-time>required

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$

401

Missing or invalid credentials

errorstringrequired

Allowed:unauthorized

403

Membership revoked or insufficient scope

errorstringrequired

Allowed:insufficient_scopeforbidden

404

Session, joined audio, or tenant database not found

errorstringrequired

Allowed:not_foundworkspace_not_found

409

Session audio is not ready

errorstringrequired

Allowed:session_not_ready

500

Unexpected server error

errorstringrequired

Allowed:internal_server_error

502

Audio storage retrieval failed

errorstringrequired

Allowed:storage_retrieval_failed

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Parameters

idpath*

Request

curl -X GET 'https://connect.torqee.app/api/v1/sessions/string/audio-url' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://connect.torqee.app/api/v1/sessions/string/audio-url", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://connect.torqee.app/api/v1/sessions/string/audio-url",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "url": "http://example.com",
  "expiresAt": "2019-08-24T14:15:22Z"
}

{
  "error": "unauthorized"
}

{
  "error": "insufficient_scope"
}

{
  "error": "not_found"
}

{
  "error": "session_not_ready"
}

{
  "error": "internal_server_error"
}

{
  "error": "storage_retrieval_failed"
}