Skip to content

docs(storage): add presigned upload URL documentation for getUrl PUT#8562

Merged
osama-rizk merged 6 commits intomainfrom
docs/presigned-upload-url
Apr 21, 2026
Merged

docs(storage): add presigned upload URL documentation for getUrl PUT#8562
osama-rizk merged 6 commits intomainfrom
docs/presigned-upload-url

Conversation

@osama-rizk
Copy link
Copy Markdown
Contributor

Description of changes:

Documents the new method: 'PUT' option for the getUrl API, which enables generating presigned URLs for
direct S3 uploads.

Changes:

  • Added "Upload using a presigned URL" section to the upload-files page with usage examples, third-party
    tool integration (DuckDB), and a dedicated options table
  • Added method row to the getUrl options table on the download-files page with a cross-link to the
    upload docs
  • Added callouts for validateObjectExistence skip behavior and Content-Type header matching requirement
  • Moved "MultiPart upload" to a subsection under "Implement upload functionality" to avoid confusion with
    presigned uploads

Related GitHub issue #, if available:

Closes #14111
Related PR: aws-amplify/amplify-js#14740

Instructions

If this PR should not be merged upon approval for any reason, please submit as a DRAFT

Which product(s) are affected by this PR (if applicable)?

  • amplify-cli
  • amplify-ui
  • amplify-studio
  • amplify-hosting
  • amplify-libraries

Which platform(s) are affected by this PR (if applicable)?

  • JS
  • Swift
  • Android
  • Flutter
  • React Native

Please add the product(s)/platform(s) affected to the PR title

Checks

  • Does this PR conform to the styleguide?

  • Does this PR include filetypes other than markdown or images? Please add or update unit tests
    accordingly.

  • Are any files being deleted with this PR? If so, have the needed redirects been created?

  • Are all links in MDX files using the MDX link syntax rather than HTML link syntax?

    ref: MDX: [link](https://docs.amplify.aws/)
    HTML: <a href="https://docs.amplify.aws/">link</a>

When this PR is ready to merge, please check the box below

  • Ready to merge

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0
license.

@osama-rizk osama-rizk force-pushed the docs/presigned-upload-url branch from 9e3c07f to 8d68d3c Compare April 16, 2026 12:52
@osama-rizk osama-rizk changed the title docs(storage): add presigned upload URL documentation for getUrl PUT … docs(storage): add presigned upload URL documentation for getUrl PUT Apr 16, 2026
soberm
soberm previously approved these changes Apr 16, 2026
pranavosu
pranavosu previously approved these changes Apr 17, 2026
* docs(storage): add Swift examples for presigned upload URL

* fix: move upload example from download page to callout link only
@harsh62 harsh62 dismissed stale reviews from pranavosu and soberm via 7ffc833 April 17, 2026 14:38
@osama-rizk osama-rizk requested a review from a team as a code owner April 21, 2026 08:58
soberm
soberm previously approved these changes Apr 21, 2026

You can also use `getUrl` with `method: 'PUT'` to generate presigned URLs for uploading files directly to S3. Learn more at [Upload using a presigned URL](/[platform]/frontend/storage/upload-files/#upload-using-a-presigned-url).

</Callout>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this callout is necessary. as the same is documented 10lines above.

bobbor
bobbor previously approved these changes Apr 21, 2026
Copy link
Copy Markdown
Member

@bobbor bobbor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NIT, about the callout.

Address review nit from bobbor: the callout duplicates information
already present in the method row of the getUrl options table.
@osama-rizk osama-rizk dismissed stale reviews from bobbor and soberm via ba5a0e7 April 21, 2026 14:30
@osama-rizk osama-rizk enabled auto-merge (squash) April 21, 2026 14:55
@osama-rizk osama-rizk merged commit c9dd7b1 into main Apr 21, 2026
13 checks passed
@osama-rizk osama-rizk deleted the docs/presigned-upload-url branch April 21, 2026 15:03
osama-rizk added a commit that referenced this pull request Apr 21, 2026
…8562)

* docs(storage): add presigned upload URL documentation for getUrl PUT method JS and swift 

---------

Co-authored-by: Harsh <6162866+harsh62@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

upload from file using presigned URL in amplify gen2

5 participants