> Source: [sk174365](https://support.checkpoint.com/results/sk/sk174365)

# sk174365 - Synchronous Anti-Virus Upload API to Appliance

| Property | Value |
|----------|-------|
| Solution ID | sk174365 |
| Date Created | 2021-09-05 |
| Last Modified | 2021-09-14 |
| Technical Level | General |
| Products | Security Gateway |
| Versions | R81.10 (EOS), R81 (EOS) |

## Solution

> **Table of Contents:**
>
> 1. Introduction
> 2. Availability
> 3. Calling the API
>
> (1) Introduction {#Introduction}
> --------------------------------
>
> By default, calls from the Anti-Virus Upload API to Appliance are asynchronous. In this configuration, the Upload API response is sent back to the client immediately when the file to be scanned by Anti-Virus is successfully uploaded to the appliance. To get the Anti-Virus scan results of the uploaded file, the client calls the Anti-Virus Query API.  
>
> This article describes the option to call synchronously the Anti-Virus Upload API to Appliance. In this configuration, the Upload API response is sent back to the client when the Anti-Virus file scan is finished. The Upload API response has the same format as the Query API response.  
>
> (2) Availability {#Availability}
> --------------------------------
>
> The synchronous Anti-Virus Upload API is supported on appliances that run [Threat Emulation Engine release 10.18 and above](https://supportcenter.checkpoint.com/supportcenter/portal?eventSubmit_doGoviewsolutiondetails=&solutionid=sk95235).  
>
> (3) Calling the API {#Version Info}
> -----------------------------------
>
> To call synchronous Anti-Virus Upload API, follow this procedure:  
>
> 1. Run this TECLI command on the appliance to set the *allow_synchronous_av_api_upload* TECLI attribute to***enabled*** :  
>
> `[Expert@HostName:0]# tecli advance attributes set allow_synchronous_av_api_upload 1`  
>
> **Note:** You need to do this just once.
>
> 2. In the *Upload API* call, in the *Request JSON* body:
>
> * Make sure that *"av"* is the only value in the *"features"*JSON array
> * Add a new JSON Boolean attribute named *synchronous_upload* with value *true*
>
> The Upload API Request JSON body:
>
> ```
> � �  {
>
>   � � �  "request" : {
>
>   � � � �� � "features" : [ "av" ],
>
>   � � � �� � "synchronous_upload" : true
>
>   � � �  }
>
> � �  }
>
> ```

---

# Agent Instructions

This content is from the Check Point Support Center (https://support.checkpoint.com), the official knowledge base for Check Point cybersecurity products.

## Navigating This Knowledge Base

- **Complete index**: [llms.txt](https://support.checkpoint.com/llms.txt)
- **All SK articles**: [SecureKnowledge Sitemap](https://support.checkpoint.com/sitemaps/secureknowledge-sitemap-index.xml)
- **SK article URL pattern**: `https://support.checkpoint.com/results/sk/{skId}`
- **Markdown responses**: AI bot User-Agents automatically receive `text/markdown` content