DAdaily
recordings

recordings/:id/access-link

Changed on

Generate an access link for a recording. The download_link is a short-lived signed URL: see the access links guide for more information.

get/recordings/{recording_id}/access-link

Request

  • Base URL
    https://api.daily.co/v1
  • Auth
    HTTP bearer

Path parameters

recording_idstring required

Query parameters

valid_for_secsinteger

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.

Response

200

download_linkstring

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

expiresinteger
storage_provider'aws' | 'oci'

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

validity_cappedboolean

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 response

{
  "download_link": "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": 1548809176,
  "storage_provider": "aws",
  "validity_capped": true
}

Changes