For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
    • NVIDIA Switch Infrastructure
    • I want to...
  • Quick Start
    • Start Here
    • Getting Started with Config Manager
    • TUI Wizard Reference
    • Configuration Samples
    • Interfaces
    • Local Development Quick Start
    • First Run Tour
  • Config Manager Overview
    • Config Manager Concepts
    • Getting Started with Nautobot
  • User Guides
    • New Site Bringup
    • Workflow Lifecycle
  • Deployment
    • Hosting Options
    • Network Topology Requirements
    • Firewall Ports
    • Airgapped Deployment
    • Troubleshooting
  • Services
      • Network ZTP
      • ZTP Architecture
      • Configuration Guide
      • Upload Images
      • ZTP API
        • GETHealthcheck
        • GETCurrent User Info
          • GETList All Files
          • GETList Files
          • GETLoad Object
          • POSTUpload File
          • GETLoad Checksum
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogo
ServicesNetwork ZTP ServiceZTP APIfiles

Upload File

||View as Markdown|
POST
https://host.com/v1/files/:platform/:version/:filename
POST
/v1/files/:platform/:version/:filename
$curl -X POST "https://host.com/v1/files/platform/version/filename?checksum=checksum" \
>     -H "Content-Type: multipart/form-data" \
>     -F file=@SGVsbG8gV29ybGQ=
1"File uploaded successfully."

Upload a file to the storage backend.

Set firmware_image=true to tag this file as the OS/firmware image for the given platform and version. Only one firmware image is allowed per platform/version directory; the upload will be rejected if a different file already occupies that slot.

Previous

Load Object

Next

Load Checksum

Path parameters

platformstringRequired
versionstringRequired
filenamestringRequired

Query parameters

checksumstringRequired
overwritebooleanOptionalDefaults to false
firmware_imagebooleanOptionalDefaults to false

Request

This endpoint expects a multipart form containing a file.
filefileRequired

Response

Successful Response

Errors

404
Not Found Error
422
Unprocessable Entity Error