Text of docs.pypi.org › api › upload as Styx crawled it on Nov 18, 2026. The page may have changed since. Only its words are kept, without pictures or layout.

Open the live page

Upload API - PyPI User Documentation

Skip to content Upload API ¶ The API endpoint served at https://upload.pypi.org/legacy/ is Warehouse's emulation of the legacy PyPI upload API. This is the endpoint that tools such as twine use to upload distributions to PyPI . Routes ¶ Upload a file ¶ Important Releases on PyPI are created by uploading one file at a time. The first file uploaded of a new version creates a release for that version, and populates its metadata.

Route: POST upload.pypi.org/legacy/ The upload API can be used to upload artifacts by sending a multipart/form-data POST request with the following fields: :action set to file_upload protocol_version set to 1 content with the file to be uploaded and the proper filename (e.g. my_foo_bar-4.2-cp36-cp36m-manylinux1_x86_64.whl ) One of the following hash digests: md5_digest set to the md5 hash of the uploaded file in urlsafe base64 with no padding sha256_digest set to the SHA2-256 hash in hexadecimal blake2_256_digest set to the Blake2b 256-bit hash in hexadecimal filetype must be set to the type of the artifact: bdist_wheel or sdist . pyversion must be set to a Python tag for bdist_wheel uploads, or source for sdist uploads. metadata_version , name and version must be set according to the Core metadata specifications attestations can be set to a JSON array of attestation objects .

PyPI will reject the upload if it can't verify each of the supplied attestations. You can set any other field from the Core metadata specifications . All fields need to be renamed to lowercase and hyphens need to replaced by underscores. Additionally, multiple-use fields (like Classifier ) are pluralized (e.g. classifiers ) with some limited exceptions noted below: Metadata field Form field Platform platform ( not platforms ) Supported-Platform supported_platform ( not supported_platforms ) License-File license_file ( not license_files ) Warning The transformation above must be performed.

Sending a form field like Description-Content-Type will not raise an error but will be silently ignored .