Skip to main content
The DownloadAuthInput type configures authentication for downloading media files during audio upload. This allows you to upload files that are hosted on private servers or require authentication.

​
Fields

​
type
DownloadAuthType
required
The authentication method to use when downloading the media file. Must be one of:
  • none - No authentication (publicly accessible URL)
  • bearer_token - Bearer token authentication
  • basic_auth - HTTP Basic authentication
See DownloadAuthType for details.
​
bearer
BearerTokenAuthInput
Bearer token configuration. Required when type is bearer_token, must not be provided for other types.See BearerTokenAuthInput for the complete schema definition.
​
basic
BasicAuthInput
Basic authentication configuration. Required when type is basic_auth, must not be provided for other types.See BasicAuthInput for the complete schema definition.

​
Validation Rules

The DownloadAuthInput type enforces mutual exclusivity between authentication methods:
  • When type is bearer_token, only the bearer field should be provided
  • When type is basic_auth, only the basic field should be provided
  • When type is none, neither bearer nor basic should be provided
Providing fields for multiple authentication types will result in a validation error.

​
Examples

​
Bearer Token Authentication

{
  type: bearer_token
  bearer: {
    token: "your-bearer-token-here"
  }
}

​
Basic Authentication

{
  type: basic_auth
  basic: {
    username: "your-username"
    password: "your-password"
  }
}

​
No Authentication (Default)

When the media file is publicly accessible, you can either omit the download_auth field entirely or explicitly set it to none: 
{
  type: none
}

​
Use Cases

​
Private Cloud Storage

Use bearer token authentication for files stored in private cloud storage with token-based access: 
mutation {
  uploadAudio(input: {
    url: "https://storage.example.com/recordings/meeting-123.mp3"
    title: "Team Standup"
    download_auth: {
      type: bearer_token
      bearer: {
        token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
      }
    }
  }) {
    success
    message
  }
}

​
Protected Web Servers

Use basic authentication for files hosted on web servers with HTTP Basic Auth: 
mutation {
  uploadAudio(input: {
    url: "https://recordings.company.com/meeting-123.mp3"
    title: "Client Call"
    download_auth: {
      type: basic_auth
      basic: {
        username: "api-user"
        password: "secure-password"
      }
    }
  }) {
    success
    message
  }
}