--- title: "/recordings/test-oci-bucket" method: GET path: "/recordings/test-oci-bucket" tags: ["recordings"] --- # /recordings/test-oci-bucket `GET /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](/docs/guides/features/recording/custom-oci-storage)). 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. ## Query parameters - `property` 'recordings_bucket' | 'transcription_bucket' - `roomName` string ## Response `200` 200 - object - `success` boolean - `recordings_bucket` RecordingsBucket — Configures an S3 bucket in which to store recordings. See the [S3 bucket guide](/guides/products/live-streaming-recording/storing-recordings-in-a-custom-s3-bucket) for more information. Properties: Supports both Amazon S3 and OCI Object Storage; select with `storage_provider`. See the [custom OCI storage guide](/docs/guides/features/recording/custom-oci-storage) for the OCI setup process. - `storage_provider` 'aws' | 'oci' — Which storage provider the bucket belongs to. Defaults to `aws` when omitted, so existing configurations are unaffected. Set to `oci` to store recordings in an Oracle Cloud Infrastructure Object Storage bucket — see the [custom OCI storage guide](/docs/guides/features/recording/custom-oci-storage). OCI buckets are not self-serve: Daily must provision credentials for your domain first. - `bucket_name` string — The name of the Amazon S3 bucket to use for recording storage. - `bucket_region` string — The region which the specified S3 bucket is located in. When `storage_provider` is `oci` this must be an OCI region such as `us-ashburn-1`, not an AWS region. - `namespace` string — **OCI only.** Your OCI Object Storage namespace. Required when `storage_provider` is `oci`, and rejected when it is `aws`. Find it in the OCI Console under Tenancy details. - `assume_role_arn` string — **AWS only.** The Amazon Resource Name (ARN) of the role Daily should assume when storing the recording in the specified bucket. Required when `storage_provider` is `aws`, and rejected when it is `oci`. - `allow_api_access` boolean — Controls whether the recording will be accessible using Daily's API. - `allow_streaming_from_bucket` boolean — Specifies which [`Content-Disposition`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) response header the recording link retrieved from the [access-link](/products/rest-api/recordings/get-recording-link) REST API endpoint will have. If `allow_streaming_from_bucket` is `false`, the header will be `Content-Dispostion: attachment`. If `allow_streaming_from_bucket` is `true`, the header will be `Content-Disposition: inline`. To play the recording link directly in the browser or embed it in a video player, set this property to `true`. Defaults to `false` - `transcription_bucket` TranscriptionBucket — Configures an S3 bucket in which to store transcriptions. See the [S3 bucket guide](/guides/products/live-streaming-recording/storing-recordings-in-a-custom-s3-bucket) for more information. Supports both Amazon S3 and OCI Object Storage; select with `storage_provider`. See the [custom OCI storage guide](/docs/guides/features/recording/custom-oci-storage) for the OCI setup process. - `storage_provider` 'aws' | 'oci' — Which storage provider the bucket belongs to. Defaults to `aws` when omitted, so existing configurations are unaffected. Set to `oci` to store transcriptions in an Oracle Cloud Infrastructure Object Storage bucket — see the [custom OCI storage guide](/docs/guides/features/recording/custom-oci-storage). OCI buckets are not self-serve: Daily must provision credentials for your domain first. - `bucket_name` string — The name of the Amazon S3 bucket to use for transcription storage. - `bucket_region` string — The region which the specified S3 bucket is located in. When `storage_provider` is `oci` this must be an OCI region such as `us-ashburn-1`, not an AWS region. - `namespace` string — **OCI only.** Your OCI Object Storage namespace. Required when `storage_provider` is `oci`, and rejected when it is `aws`. Find it in the OCI Console under Tenancy details. - `assume_role_arn` string — **AWS only.** The Amazon Resource Name (ARN) of the role Daily should assume when storing the transcription in the specified bucket. Required when `storage_provider` is `aws`, and rejected when it is `oci`. - `allow_api_access` boolean — Whether the transcription should be accessible using Daily's API. - `test_file_key` string — The object key of the test file written to your bucket. - `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. - `expires` integer — When `download_link` expires, as a unix timestamp. Returned only when `allow_api_access` is `true`. ## Other responses - `400` — 400 - `404` — 404 — the room named by `roomName` does not exist in this domain. ## Changes - **2026-08-31** `879e566d82a2` — 1 info - endpoint added [Change history](https://skmtc.dev/daily/apis/daily-api/changes/recordings/test-oci-bucket/get.md) --- [API](https://skmtc.dev/daily/apis/daily-api.md) · [All operations](https://skmtc.dev/daily/apis/daily-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/daily/daily-api/revisions/879e566d82a2/schema)