Skip to main content
GET
recordings/:id/access-link

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

recording_id
string
required

Query Parameters

valid_for_secs
integer<int32>
default:3600

How long the returned download_link remains valid, in seconds. Accepts 900 (15 minutes) through 43200 (12 hours). A value outside that range returns a 400.

Read the response's expires field rather than adding valid_for_secs to the current time. expires is the Unix timestamp at which the link stops working, and it is authoritative when Daily grants a shorter lifetime than the one requested.

Recordings stored in your own Amazon S3 bucket have a maximum link lifetime of 3600 seconds. A larger valid_for_secs still returns a 200, with expires set one hour out and validity_capped set to true. Request a new link when you need the file again. Recordings in Daily storage and in customer-owned OCI Object Storage buckets are not affected. See Custom S3 storage.

Required range: 900 <= x <= 43200

Response

200

A short-lived signed download URL that must be used exactly as returned. See the access links guide for more information.

Example:

"https://b.daily.co/recordings/api-demo/hello/1548790973821?dl=api-demo%2Fhello%2F1548790973821.webm&Expires=1548809176&Signature=Gt5RhZ0kXksNriqmlm~T9hbq-asExampleSignature_&Key-Pair-Id=K1EXAMPLEKEYPAIR"

expires
integer
default:0
Example:

1548809176

storage_provider
enum<string>

The storage provider the recording was written to. aws for Amazon S3 (including Daily's own storage), oci for OCI Object Storage.

Available options:
aws,
oci
Example:

"aws"

validity_capped
boolean

Present and true only when the requested valid_for_secs exceeded the maximum lifetime allowed for where this recording is stored, and the link was signed for the shorter lifetime instead. Absent otherwise. expires always reports the lifetime actually granted, so a client that reads expires needs no special handling for this case.

Example:

true