> ## 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.

# UploadUrlResponse

> Schema for UploadUrlResponse

The `UploadUrlResponse` type is returned by the [createUploadUrl](https://docs.fireflies.ai/graphql-api/mutation/create-upload-url) mutation. It contains the pre-signed upload (a URL and, for a form POST, the form fields signed for it) and metadata about the upload session.

**upload\_url** `String!`

The URL to upload your file to, with `upload_method`. For `POST`, send a multipart form with every `upload_fields` entry as a form field, then the file last, as the field named `file`. For `PUT`, send the file as the request body, with a `Content-Type` header equal to the `content_type` you requested. See [Uploading the File](https://docs.fireflies.ai/graphql-api/mutation/create-upload-url#uploading-the-file).

**upload\_method** `UploadMethod!`

The HTTP method of the upload: the `upload_method` requested in [createUploadUrl](https://docs.fireflies.ai/graphql-api/mutation/create-upload-url), or `PUT` when none was. See [UploadMethod](#uploadmethod).

**upload\_fields** `[UploadFormField!]!`

For `POST`, the form fields the upload was signed with. Send each one unchanged, in any order, before the file. The names depend on the storage provider, so read them from the response instead of hard-coding them. Empty for `PUT`.

**meeting\_id** `String!`

The unique identifier for the meeting. Use this ID when calling [confirmUpload](https://docs.fireflies.ai/graphql-api/mutation/confirm-upload) after uploading the file.

**expires\_at** `String!`

ISO 8601 timestamp indicating when the upload URL expires. URLs are valid for 1 hour from creation.

## UploadMethod

How the file is uploaded to `upload_url`. `createUploadUrl` takes it as the optional `upload_method` input and returns it as `upload_method`.

| Value | Upload |
| - | - |
| `POST` | Recommended. A multipart form: every `upload_fields` entry as a form field, then the file last, as the field named `file`. Storage refuses a file over the [size limit](https://docs.fireflies.ai/graphql-api/mutation/create-upload-url#file-size-limits) for its type. |
| `PUT` | The default. The file as the request body, with a `Content-Type` header equal to the requested `content_type`. Storage does not limit its size; [confirmUpload](https://docs.fireflies.ai/graphql-api/mutation/confirm-upload) refuses a file over the size limit. `upload_fields` is empty. |

## UploadFormField

One field of the signed upload form.

**name** `String!`

The form field name, for example `key`, `Content-Type`, `policy` or `x-goog-signature`.

**value** `String!`

The value to send for the field, unchanged.

## Example Response

With `upload_method: POST`:

```json theme={null}
{
  "upload_url": "https://storage.googleapis.com/fireflies-bucket",
  "upload_method": "POST",
  "upload_fields": [
    { "name": "key", "value": "abc123def456/audio.mp3" },
    { "name": "Content-Type", "value": "audio/mpeg" },
    { "name": "policy", "value": "eyJjb25kaXRpb25zIjpb..." },
    { "name": "x-goog-algorithm", "value": "GOOG4-RSA-SHA256" },
    { "name": "x-goog-credential", "value": "uploader@project.iam.gserviceaccount.com/20240115/auto/storage/goog4_request" },
    { "name": "x-goog-date", "value": "20240115T110000Z" },
    { "name": "x-goog-signature", "value": "5f2c..." }
  ],
  "meeting_id": "abc123def456",
  "expires_at": "2024-01-15T12:00:00.000Z"
}
```

With `upload_method: PUT`, or none:

```json theme={null}
{
  "upload_url": "https://storage.googleapis.com/fireflies-bucket/abc123def456/audio.mp3?X-Goog-Algorithm=GOOG4-RSA-SHA256&...",
  "upload_method": "PUT",
  "upload_fields": [],
  "meeting_id": "abc123def456",
  "expires_at": "2024-01-15T12:00:00.000Z"
}
```

## Additional Resources

> [card] [Create Upload URL](https://docs.fireflies.ai/graphql-api/mutation/create-upload-url)
>
> Generate a pre-signed upload form or URL

> [card] [Confirm Upload](https://docs.fireflies.ai/graphql-api/mutation/confirm-upload)
>
> Confirm the upload and start transcription


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.