Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fireflies.ai/llms.txt

Use this file to discover all available pages before exploring further.

The DownloadAuthType enum specifies the authentication method to use when downloading media files during audio upload.

​
Values

​
none
Enum Value
No authentication required. The media file is publicly accessible.This is the default when download_auth is not provided.
​
bearer_token
Enum Value
Bearer token authentication. Requires the bearer field with a token.Fireflies will send Authorization: Bearer <token> when downloading the file.
​
basic_auth
Enum Value
HTTP Basic authentication. Requires the basic field with username and/or password.Fireflies will send Authorization: Basic <base64(username:password)> when downloading the file.

​
Usage

The DownloadAuthType enum is used in the DownloadAuthInput type to specify which authentication method should be used: 
input DownloadAuthInput {
  type: DownloadAuthType!
  bearer: BearerTokenAuthInput
  basic: BasicAuthInput
}

​
Examples

​
No Authentication (Default)

mutation {
  uploadAudio(input: {
    url: "https://public-storage.com/audio.mp3"
    title: "Public Recording"
    # download_auth omitted - defaults to 'none'
  }) {
    success
    message
  }
}
Or explicitly: 
mutation {
  uploadAudio(input: {
    url: "https://public-storage.com/audio.mp3"
    title: "Public Recording"
    download_auth: {
      type: none
    }
  }) {
    success
    message
  }
}

​
Bearer Token

mutation {
  uploadAudio(input: {
    url: "https://protected-storage.com/audio.mp3"
    title: "Protected Recording"
    download_auth: {
      type: bearer_token
      bearer: {
        token: "your-token-here"
      }
    }
  }) {
    success
    message
  }
}

​
Basic Authentication

mutation {
  uploadAudio(input: {
    url: "https://private-server.com/audio.mp3"
    title: "Private Recording"
    download_auth: {
      type: basic_auth
      basic: {
        username: "user"
        password: "pass"
      }
    }
  }) {
    success
    message
  }
}

​
Choosing the Right Authentication Method

MethodUse WhenExample Use Cases
noneFile is publicly accessiblePublic S3 buckets, CDN-hosted files, public web servers
bearer_tokenFile requires OAuth or API tokenPrivate cloud storage, API-protected resources, JWT-authenticated endpoints
basic_authFile requires username/passwordWeb servers with .htaccess, internal file servers, legacy systems