main
s3

Generate a signed S3 URL

Changed on

Return a short-lived signed URL for a file stored on S3 / MinIO.

Access Control:

  • Known org-scoped keys (for example campaigns/{org_id}/... and recordings/{org_id}/{recording_id}/...) are authorized by matching the org_id against the requesting user's organization.
  • Legacy keys (recordings/{run_id}.wav, transcripts/{run_id}.txt) are authorized via the workflow run they belong to.
  • Superusers can request any key.
get/api/v1/s3/signed-url

Request

  • Base URL
    https://app.dograh.com
  • URL
    https://app.dograh.com/api/v1/s3/signed-url
  • Auth
    none declared

Query parameters

keystring required

S3 object key

expires_ininteger
inlineboolean
storage_backendstring nullable

Storage backend to use (e.g. 'minio', 's3'). When omitted the backend is inferred from the resource.

Headers

authorizationstring nullable
X-API-Keystring nullable

Response

Successful Response

urlstring required
expires_ininteger required

Changes