/recordings/test-oci-bucket

curl --request GET \
  --url https://api.daily.co/v1/recordings/test-oci-bucket \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.daily.co/v1/recordings/test-oci-bucket', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.daily.co/v1/recordings/test-oci-bucket",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.daily.co/v1/recordings/test-oci-bucket"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.daily.co/v1/recordings/test-oci-bucket")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "recordings_bucket": {
    "storage_provider": "oci",
    "namespace": "axaxnpcrorw5",
    "bucket_region": "eu-frankfurt-1",
    "bucket_name": "my-daily-recordings",
    "allow_api_access": true,
    "allow_streaming_from_bucket": false
  },
  "test_file_key": "daily-co-test-upload.txt",
  "download_link": "https://axaxnpcrorw5.compat.objectstorage.eu-frankfurt-1.oraclecloud.com/my-daily-recordings/daily-co-test-upload.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%3Credacted%3E%2F20260820%2Feu-frankfurt-1%2Fs3%2Faws4_request&X-Amz-Date=20260820T125850Z&X-Amz-Expires=3600&X-Amz-Signature=%3Credacted%3E&X-Amz-SignedHeaders=host",
  "expires": 1787234330
}

{
  "error": "invalid-request-error",
  "info": "missing required field"
}

Recordings

Test OCI Bucket

Verify that an OCI bucket configuration works, by uploading a small test file (daily-co-test-upload.txt) to it through the OCI S3 compatibility API.

Unlike S3 buckets, an OCI bucket configuration is not checked when you set it — the Admit policy may not have propagated yet (see the custom OCI storage guide). Setting the property therefore succeeds even when the bucket is not usable, and this endpoint is how you confirm the setup before relying on it.

Only OCI buckets can be tested. Calling this against a bucket whose storage_provider is aws returns a 400.

On success the response echoes the tested configuration under a key matching the property query parameter — recordings_bucket by default, or transcription_bucket. A download_link and expires are returned only when the configuration has allow_api_access set to true; the link is valid for one hour. Storage credentials are never included in the response.

GET

recordings

test-oci-bucket

/recordings/test-oci-bucket

curl --request GET \
  --url https://api.daily.co/v1/recordings/test-oci-bucket \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.daily.co/v1/recordings/test-oci-bucket', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.daily.co/v1/recordings/test-oci-bucket",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.daily.co/v1/recordings/test-oci-bucket"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.daily.co/v1/recordings/test-oci-bucket")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "recordings_bucket": {
    "storage_provider": "oci",
    "namespace": "axaxnpcrorw5",
    "bucket_region": "eu-frankfurt-1",
    "bucket_name": "my-daily-recordings",
    "allow_api_access": true,
    "allow_streaming_from_bucket": false
  },
  "test_file_key": "daily-co-test-upload.txt",
  "download_link": "https://axaxnpcrorw5.compat.objectstorage.eu-frankfurt-1.oraclecloud.com/my-daily-recordings/daily-co-test-upload.txt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=%3Credacted%3E%2F20260820%2Feu-frankfurt-1%2Fs3%2Faws4_request&X-Amz-Date=20260820T125850Z&X-Amz-Expires=3600&X-Amz-Signature=%3Credacted%3E&X-Amz-SignedHeaders=host",
  "expires": 1787234330
}

{
  "error": "invalid-request-error",
  "info": "missing required field"
}

Authorizations

Authorization

string

header

required

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

Query Parameters

property

enum<string>

default:recordings_bucket

Which bucket property to test. Defaults to recordings_bucket.

Available options:

recordings_bucket,

transcription_bucket

roomName

string

Test the property set on this room instead of the domain-level property. There is no fallback to the domain configuration: if the room does not set the property, the request returns a 400.

Response

200

success

boolean

Example:

true

recordings_bucket

object

The configuration that was tested. Returned only when property is recordings_bucket (the default). Exactly one of recordings_bucket or transcription_bucket is present in a response, never both.

Show child attributes

transcription_bucket

object

The configuration that was tested. Returned only when property is transcription_bucket. Exactly one of recordings_bucket or transcription_bucket is present in a response, never both.

Show child attributes

test_file_key

string

The object key of the test file written to your bucket.

Example:

"daily-co-test-upload.txt"

download_link

string

A presigned link to the test file, valid for one hour. Only a real link when allow_api_access is true; otherwise a short string explaining that no link was generated.

Example:

"https://axaxnpcrorw5.compat.objectstorage.us-ashburn-1.oraclecloud.com/my-daily-recordings/daily-co-test-upload.txt?..."

expires

integer

When download_link expires, as a unix timestamp. Returned only when allow_api_access is true.

Example:

1787234330