# petstore_api.PetApi All URIs are relative to *http://petstore.swagger.io:80/v2* Method | HTTP request | Description ------------- | ------------- | ------------- [**add_pet**](PetApi.md#add_pet) | **POST** /pet | Add a new pet to the store [**delete_pet**](PetApi.md#delete_pet) | **DELETE** /pet/{petId} | Deletes a pet [**find_pets_by_status**](PetApi.md#find_pets_by_status) | **GET** /pet/findByStatus | Finds Pets by status [**find_pets_by_tags**](PetApi.md#find_pets_by_tags) | **GET** /pet/findByTags | Finds Pets by tags [**get_pet_by_id**](PetApi.md#get_pet_by_id) | **GET** /pet/{petId} | Find pet by ID [**update_pet**](PetApi.md#update_pet) | **PUT** /pet | Update an existing pet [**update_pet_with_form**](PetApi.md#update_pet_with_form) | **POST** /pet/{petId} | Updates a pet in the store with form data [**upload_file**](PetApi.md#upload_file) | **POST** /pet/{petId}/uploadImage | uploads an image [**upload_file_with_required_file**](PetApi.md#upload_file_with_required_file) | **POST** /fake/{petId}/uploadImageWithRequiredFile | uploads an image (required) # **add_pet** > add_pet(pet) Add a new pet to the store ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.models.pet import Pet from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Configure HTTP message signature: http_signature_test # The HTTP Signature Header mechanism that can be used by a client to # authenticate the sender of a message and ensure that particular headers # have not been modified in transit. # # You can specify the signing key-id, private key path, signing scheme, # signing algorithm, list of signed headers and signature max validity. # The 'key_id' parameter is an opaque string that the API server can use # to lookup the client and validate the signature. # The 'private_key_path' parameter should be the path to a file that # contains a DER or base-64 encoded private key. # The 'private_key_passphrase' parameter is optional. Set the passphrase # if the private key is encrypted. # The 'signed_headers' parameter is used to specify the list of # HTTP headers included when generating the signature for the message. # You can specify HTTP headers that you want to protect with a cryptographic # signature. Note that proxies may add, modify or remove HTTP headers # for legitimate reasons, so you should only add headers that you know # will not be modified. For example, if you want to protect the HTTP request # body, you can specify the Digest header. In that case, the client calculates # the digest of the HTTP request body and includes the digest in the message # signature. # The 'signature_max_validity' parameter is optional. It is configured as a # duration to express when the signature ceases to be valid. The client calculates # the expiration date every time it generates the cryptographic signature # of an HTTP request. The API server may have its own security policy # that controls the maximum validity of the signature. The client max validity # must be lower than the server max validity. # The time on the client and server must be synchronized, otherwise the # server may reject the client signature. # # The client must use a combination of private key, signing scheme, # signing algorithm and hash algorithm that matches the security policy of # the API server. # # See petstore_api.signing for a list of all supported parameters. from petstore_api import signing import datetime configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2", signing_info = petstore_api.HttpSigningConfiguration( key_id = 'my-key-id', private_key_path = 'private_key.pem', private_key_passphrase = 'YOUR_PASSPHRASE', signing_scheme = petstore_api.signing.SCHEME_HS2019, signing_algorithm = petstore_api.signing.ALGORITHM_ECDSA_MODE_FIPS_186_3, hash_algorithm = petstore_api.signing.SCHEME_RSA_SHA256, signed_headers = [ petstore_api.signing.HEADER_REQUEST_TARGET, petstore_api.signing.HEADER_CREATED, petstore_api.signing.HEADER_EXPIRES, petstore_api.signing.HEADER_HOST, petstore_api.signing.HEADER_DATE, petstore_api.signing.HEADER_DIGEST, 'Content-Type', 'Content-Length', 'User-Agent' ], signature_max_validity = datetime.timedelta(minutes=5) ) ) # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet = petstore_api.Pet() # Pet | Pet object that needs to be added to the store try: # Add a new pet to the store api_instance.add_pet(pet) except Exception as e: print("Exception when calling PetApi->add_pet: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet** | [**Pet**](Pet.md)| Pet object that needs to be added to the store | ### Return type void (empty response body) ### Authorization [petstore_auth](../README.md#petstore_auth), [http_signature_test](../README.md#http_signature_test) ### HTTP request headers - **Content-Type**: application/json, application/xml - **Accept**: Not defined ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Successful operation | - | **405** | Invalid input | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **delete_pet** > delete_pet(pet_id, api_key=api_key) Deletes a pet ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet_id = 56 # int | Pet id to delete api_key = 'api_key_example' # str | (optional) try: # Deletes a pet api_instance.delete_pet(pet_id, api_key=api_key) except Exception as e: print("Exception when calling PetApi->delete_pet: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet_id** | **int**| Pet id to delete | **api_key** | **str**| | [optional] ### Return type void (empty response body) ### Authorization [petstore_auth](../README.md#petstore_auth) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: Not defined ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Successful operation | - | **400** | Invalid pet value | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **find_pets_by_status** > List[Pet] find_pets_by_status(status) Finds Pets by status Multiple status values can be provided with comma separated strings ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.models.pet import Pet from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Configure HTTP message signature: http_signature_test # The HTTP Signature Header mechanism that can be used by a client to # authenticate the sender of a message and ensure that particular headers # have not been modified in transit. # # You can specify the signing key-id, private key path, signing scheme, # signing algorithm, list of signed headers and signature max validity. # The 'key_id' parameter is an opaque string that the API server can use # to lookup the client and validate the signature. # The 'private_key_path' parameter should be the path to a file that # contains a DER or base-64 encoded private key. # The 'private_key_passphrase' parameter is optional. Set the passphrase # if the private key is encrypted. # The 'signed_headers' parameter is used to specify the list of # HTTP headers included when generating the signature for the message. # You can specify HTTP headers that you want to protect with a cryptographic # signature. Note that proxies may add, modify or remove HTTP headers # for legitimate reasons, so you should only add headers that you know # will not be modified. For example, if you want to protect the HTTP request # body, you can specify the Digest header. In that case, the client calculates # the digest of the HTTP request body and includes the digest in the message # signature. # The 'signature_max_validity' parameter is optional. It is configured as a # duration to express when the signature ceases to be valid. The client calculates # the expiration date every time it generates the cryptographic signature # of an HTTP request. The API server may have its own security policy # that controls the maximum validity of the signature. The client max validity # must be lower than the server max validity. # The time on the client and server must be synchronized, otherwise the # server may reject the client signature. # # The client must use a combination of private key, signing scheme, # signing algorithm and hash algorithm that matches the security policy of # the API server. # # See petstore_api.signing for a list of all supported parameters. from petstore_api import signing import datetime configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2", signing_info = petstore_api.HttpSigningConfiguration( key_id = 'my-key-id', private_key_path = 'private_key.pem', private_key_passphrase = 'YOUR_PASSPHRASE', signing_scheme = petstore_api.signing.SCHEME_HS2019, signing_algorithm = petstore_api.signing.ALGORITHM_ECDSA_MODE_FIPS_186_3, hash_algorithm = petstore_api.signing.SCHEME_RSA_SHA256, signed_headers = [ petstore_api.signing.HEADER_REQUEST_TARGET, petstore_api.signing.HEADER_CREATED, petstore_api.signing.HEADER_EXPIRES, petstore_api.signing.HEADER_HOST, petstore_api.signing.HEADER_DATE, petstore_api.signing.HEADER_DIGEST, 'Content-Type', 'Content-Length', 'User-Agent' ], signature_max_validity = datetime.timedelta(minutes=5) ) ) # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) status = ['status_example'] # List[str] | Status values that need to be considered for filter try: # Finds Pets by status api_response = api_instance.find_pets_by_status(status) print("The response of PetApi->find_pets_by_status:\n") pprint(api_response) except Exception as e: print("Exception when calling PetApi->find_pets_by_status: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **status** | [**List[str]**](str.md)| Status values that need to be considered for filter | ### Return type [**List[Pet]**](Pet.md) ### Authorization [petstore_auth](../README.md#petstore_auth), [http_signature_test](../README.md#http_signature_test) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/xml, application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | successful operation | - | **400** | Invalid status value | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **find_pets_by_tags** > List[Pet] find_pets_by_tags(tags) Finds Pets by tags Multiple tags can be provided with comma separated strings. Use tag1, tag2, tag3 for testing. ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.models.pet import Pet from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Configure HTTP message signature: http_signature_test # The HTTP Signature Header mechanism that can be used by a client to # authenticate the sender of a message and ensure that particular headers # have not been modified in transit. # # You can specify the signing key-id, private key path, signing scheme, # signing algorithm, list of signed headers and signature max validity. # The 'key_id' parameter is an opaque string that the API server can use # to lookup the client and validate the signature. # The 'private_key_path' parameter should be the path to a file that # contains a DER or base-64 encoded private key. # The 'private_key_passphrase' parameter is optional. Set the passphrase # if the private key is encrypted. # The 'signed_headers' parameter is used to specify the list of # HTTP headers included when generating the signature for the message. # You can specify HTTP headers that you want to protect with a cryptographic # signature. Note that proxies may add, modify or remove HTTP headers # for legitimate reasons, so you should only add headers that you know # will not be modified. For example, if you want to protect the HTTP request # body, you can specify the Digest header. In that case, the client calculates # the digest of the HTTP request body and includes the digest in the message # signature. # The 'signature_max_validity' parameter is optional. It is configured as a # duration to express when the signature ceases to be valid. The client calculates # the expiration date every time it generates the cryptographic signature # of an HTTP request. The API server may have its own security policy # that controls the maximum validity of the signature. The client max validity # must be lower than the server max validity. # The time on the client and server must be synchronized, otherwise the # server may reject the client signature. # # The client must use a combination of private key, signing scheme, # signing algorithm and hash algorithm that matches the security policy of # the API server. # # See petstore_api.signing for a list of all supported parameters. from petstore_api import signing import datetime configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2", signing_info = petstore_api.HttpSigningConfiguration( key_id = 'my-key-id', private_key_path = 'private_key.pem', private_key_passphrase = 'YOUR_PASSPHRASE', signing_scheme = petstore_api.signing.SCHEME_HS2019, signing_algorithm = petstore_api.signing.ALGORITHM_ECDSA_MODE_FIPS_186_3, hash_algorithm = petstore_api.signing.SCHEME_RSA_SHA256, signed_headers = [ petstore_api.signing.HEADER_REQUEST_TARGET, petstore_api.signing.HEADER_CREATED, petstore_api.signing.HEADER_EXPIRES, petstore_api.signing.HEADER_HOST, petstore_api.signing.HEADER_DATE, petstore_api.signing.HEADER_DIGEST, 'Content-Type', 'Content-Length', 'User-Agent' ], signature_max_validity = datetime.timedelta(minutes=5) ) ) # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) tags = ['tags_example'] # List[str] | Tags to filter by try: # Finds Pets by tags api_response = api_instance.find_pets_by_tags(tags) print("The response of PetApi->find_pets_by_tags:\n") pprint(api_response) except Exception as e: print("Exception when calling PetApi->find_pets_by_tags: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **tags** | [**List[str]**](str.md)| Tags to filter by | ### Return type [**List[Pet]**](Pet.md) ### Authorization [petstore_auth](../README.md#petstore_auth), [http_signature_test](../README.md#http_signature_test) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/xml, application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | successful operation | - | **400** | Invalid tag value | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **get_pet_by_id** > Pet get_pet_by_id(pet_id) Find pet by ID Returns a single pet ### Example * Api Key Authentication (api_key): ```python import time import os import petstore_api from petstore_api.models.pet import Pet from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. # Configure API key authorization: api_key configuration.api_key['api_key'] = os.environ["API_KEY"] # Uncomment below to setup prefix (e.g. Bearer) for API key, if needed # configuration.api_key_prefix['api_key'] = 'Bearer' # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet_id = 56 # int | ID of pet to return try: # Find pet by ID api_response = api_instance.get_pet_by_id(pet_id) print("The response of PetApi->get_pet_by_id:\n") pprint(api_response) except Exception as e: print("Exception when calling PetApi->get_pet_by_id: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet_id** | **int**| ID of pet to return | ### Return type [**Pet**](Pet.md) ### Authorization [api_key](../README.md#api_key) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/xml, application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | successful operation | - | **400** | Invalid ID supplied | - | **404** | Pet not found | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **update_pet** > update_pet(pet) Update an existing pet ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.models.pet import Pet from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Configure HTTP message signature: http_signature_test # The HTTP Signature Header mechanism that can be used by a client to # authenticate the sender of a message and ensure that particular headers # have not been modified in transit. # # You can specify the signing key-id, private key path, signing scheme, # signing algorithm, list of signed headers and signature max validity. # The 'key_id' parameter is an opaque string that the API server can use # to lookup the client and validate the signature. # The 'private_key_path' parameter should be the path to a file that # contains a DER or base-64 encoded private key. # The 'private_key_passphrase' parameter is optional. Set the passphrase # if the private key is encrypted. # The 'signed_headers' parameter is used to specify the list of # HTTP headers included when generating the signature for the message. # You can specify HTTP headers that you want to protect with a cryptographic # signature. Note that proxies may add, modify or remove HTTP headers # for legitimate reasons, so you should only add headers that you know # will not be modified. For example, if you want to protect the HTTP request # body, you can specify the Digest header. In that case, the client calculates # the digest of the HTTP request body and includes the digest in the message # signature. # The 'signature_max_validity' parameter is optional. It is configured as a # duration to express when the signature ceases to be valid. The client calculates # the expiration date every time it generates the cryptographic signature # of an HTTP request. The API server may have its own security policy # that controls the maximum validity of the signature. The client max validity # must be lower than the server max validity. # The time on the client and server must be synchronized, otherwise the # server may reject the client signature. # # The client must use a combination of private key, signing scheme, # signing algorithm and hash algorithm that matches the security policy of # the API server. # # See petstore_api.signing for a list of all supported parameters. from petstore_api import signing import datetime configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2", signing_info = petstore_api.HttpSigningConfiguration( key_id = 'my-key-id', private_key_path = 'private_key.pem', private_key_passphrase = 'YOUR_PASSPHRASE', signing_scheme = petstore_api.signing.SCHEME_HS2019, signing_algorithm = petstore_api.signing.ALGORITHM_ECDSA_MODE_FIPS_186_3, hash_algorithm = petstore_api.signing.SCHEME_RSA_SHA256, signed_headers = [ petstore_api.signing.HEADER_REQUEST_TARGET, petstore_api.signing.HEADER_CREATED, petstore_api.signing.HEADER_EXPIRES, petstore_api.signing.HEADER_HOST, petstore_api.signing.HEADER_DATE, petstore_api.signing.HEADER_DIGEST, 'Content-Type', 'Content-Length', 'User-Agent' ], signature_max_validity = datetime.timedelta(minutes=5) ) ) # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet = petstore_api.Pet() # Pet | Pet object that needs to be added to the store try: # Update an existing pet api_instance.update_pet(pet) except Exception as e: print("Exception when calling PetApi->update_pet: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet** | [**Pet**](Pet.md)| Pet object that needs to be added to the store | ### Return type void (empty response body) ### Authorization [petstore_auth](../README.md#petstore_auth), [http_signature_test](../README.md#http_signature_test) ### HTTP request headers - **Content-Type**: application/json, application/xml - **Accept**: Not defined ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Successful operation | - | **400** | Invalid ID supplied | - | **404** | Pet not found | - | **405** | Validation exception | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **update_pet_with_form** > update_pet_with_form(pet_id, name=name, status=status) Updates a pet in the store with form data ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet_id = 56 # int | ID of pet that needs to be updated name = 'name_example' # str | Updated name of the pet (optional) status = 'status_example' # str | Updated status of the pet (optional) try: # Updates a pet in the store with form data api_instance.update_pet_with_form(pet_id, name=name, status=status) except Exception as e: print("Exception when calling PetApi->update_pet_with_form: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet_id** | **int**| ID of pet that needs to be updated | **name** | **str**| Updated name of the pet | [optional] **status** | **str**| Updated status of the pet | [optional] ### Return type void (empty response body) ### Authorization [petstore_auth](../README.md#petstore_auth) ### HTTP request headers - **Content-Type**: application/x-www-form-urlencoded - **Accept**: Not defined ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Successful operation | - | **405** | Invalid input | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **upload_file** > ApiResponse upload_file(pet_id, additional_metadata=additional_metadata, file=file) uploads an image ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.models.api_response import ApiResponse from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet_id = 56 # int | ID of pet to update additional_metadata = 'additional_metadata_example' # str | Additional data to pass to server (optional) file = None # bytearray | file to upload (optional) try: # uploads an image api_response = api_instance.upload_file(pet_id, additional_metadata=additional_metadata, file=file) print("The response of PetApi->upload_file:\n") pprint(api_response) except Exception as e: print("Exception when calling PetApi->upload_file: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet_id** | **int**| ID of pet to update | **additional_metadata** | **str**| Additional data to pass to server | [optional] **file** | **bytearray**| file to upload | [optional] ### Return type [**ApiResponse**](ApiResponse.md) ### Authorization [petstore_auth](../README.md#petstore_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | successful operation | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **upload_file_with_required_file** > ApiResponse upload_file_with_required_file(pet_id, required_file, additional_metadata=additional_metadata) uploads an image (required) ### Example * OAuth Authentication (petstore_auth): ```python import time import os import petstore_api from petstore_api.models.api_response import ApiResponse from petstore_api.rest import ApiException from pprint import pprint # Defining the host is optional and defaults to http://petstore.swagger.io:80/v2 # See configuration.py for a list of all supported configuration parameters. configuration = petstore_api.Configuration( host = "http://petstore.swagger.io:80/v2" ) # The client must configure the authentication and authorization parameters # in accordance with the API server security policy. # Examples for each auth method are provided below, use the example that # satisfies your auth use case. configuration.access_token = os.environ["ACCESS_TOKEN"] # Enter a context with an instance of the API client with petstore_api.ApiClient(configuration) as api_client: # Create an instance of the API class api_instance = petstore_api.PetApi(api_client) pet_id = 56 # int | ID of pet to update required_file = None # bytearray | file to upload additional_metadata = 'additional_metadata_example' # str | Additional data to pass to server (optional) try: # uploads an image (required) api_response = api_instance.upload_file_with_required_file(pet_id, required_file, additional_metadata=additional_metadata) print("The response of PetApi->upload_file_with_required_file:\n") pprint(api_response) except Exception as e: print("Exception when calling PetApi->upload_file_with_required_file: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **pet_id** | **int**| ID of pet to update | **required_file** | **bytearray**| file to upload | **additional_metadata** | **str**| Additional data to pass to server | [optional] ### Return type [**ApiResponse**](ApiResponse.md) ### Authorization [petstore_auth](../README.md#petstore_auth) ### HTTP request headers - **Content-Type**: multipart/form-data - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | successful operation | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)