Sample - Swagger Petstore OpenAPI 3
POST/pet/{petId}/uploadImage

Upload a pet image

Uploads an image for a specific pet in the store. Supply petId and send the image as binary request content; use additionalMetadata to attach optional metadata to the upload. Returns a processing result containing a code, type, and message.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
petIdintegerrequired
The integer identifier of the pet whose image you are uploading.
additionalMetadatastringoptional
Optional metadata to associate with the uploaded image. Defaults to no additional metadata when omitted.

4 status codes
200Returns an upload result containing a processing code, result type, and message.
codeintegeroptional
typestringoptional
messagestringoptional
400Returned when no file is uploaded.
404Returned when no pet exists with the supplied `petId`.
defaultReturned when an unexpected error occurs.

Error handling

A 400 is returned when no binary file is uploaded. A 404 is returned when no pet exists with the supplied petId. Send the image in the request body and use additionalMetadata only for supplementary upload information.