ServicesNetwork ZTP ServiceZTP APIfiles

Upload File

View as Markdown

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.

Authentication

AuthorizationBearer

Bearer JWT used by CLI and machine clients on svc-* endpoints. Authentication is required by default, but deployments may disable it with [auth] required = false. Browser OIDC sessions, mTLS, SPIFFE identities, and trusted gateway identity headers may also satisfy authentication outside this generated client flow.

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