# Quiz Submission Files

{% hint style="warning" %}
**Welcome to Our New API Docs!** This is the new home for all things API (previously at [Canvas LMS REST API Documentation](https://api.instructure.com)).
{% endhint %}

## Quiz Submission Files API

### [Upload a file](#method.quizzes/quiz_submission_files.create) <a href="#method.quizzes-quiz_submission_files.create" id="method.quizzes-quiz_submission_files.create"></a>

[Quizzes::QuizSubmissionFilesController#create](https://github.com/instructure/canvas-lms/blob/master/app/controllers/quizzes/quiz_submission_files_controller.rb)

**`POST /api/v1/courses/:course_id/quizzes/:quiz_id/submissions/self/files`**

**Scope:** `url:POST|/api/v1/courses/:course_id/quizzes/:quiz_id/submissions/self/files`

Associate a new quiz submission file

This API endpoint is the first step in uploading a quiz submission file. See the [File Upload Documentation](https://developerdocs.instructure.com/services/canvas/basics/file.file_uploads) for details on the file upload workflow as these parameters are interpreted as per the documentation there.

**Request Parameters:**

| Parameter      | Type     | Description                          |
| -------------- | -------- | ------------------------------------ |
| `name`         | `string` | The name of the quiz submission file |
| `on_duplicate` | `string` | How to handle duplicate names        |

**Example Response:**

```js
{
  "attachments": [
    {
      "upload_url": "https://some-bucket.s3.amazonaws.com/",
      "upload_params": {
        "key": "/users/1234/files/answer_pic.jpg",
        "acl": "private",
        "Filename": "answer_pic.jpg",
        "AWSAccessKeyId": "some_id",
        "Policy": "some_opaque_string",
        "Signature": "another_opaque_string",
        "Content-Type": "image/jpeg"
      }
    }
  ]
}
```

***

This documentation is generated directly from the Canvas LMS source code, available [on Github](https://github.com/instructure/canvas-lms).