Focus

WildFire API Reference

Submit a Local File to WildFire (API)

Table of Contents

Submit a Local File to WildFire (API)

The WildFire API lets you submit a local supported file type for WildFire analysis. Use this resource automate the submission of new files, such as when using a VPN service.

Ensure that you submit a valid file type when you submit a local file because uploads are limited by WildFire API Access Control.

Resource

/submit/file/

Request Parameters

Use the following form parameters when you submit a local file for WildFire analysis:

Parameters	Description	Example
apikey	(`Required`) API key	Example: apikey=<API KEY>
agent	(`Required for Prisma Access and Prisma Cloud Compute-based WildFire public API keys`) Designates the API key type	Example: agent=pcc Options include: pcc—for use with Prisma Cloud Compute-based WildFire public API keys prismaaccessapi—for use with Prisma Access-based WildFire public API keys
file	(`Required`) Local path to file	Example: file=@c:\pdf.pdf

Example Request

Make a POST request to the /submit/file resource and include the API key along with the local file including the filename, similar to the following cURL command:

curl -F 'apikey=<API KEY>'
-F 'file=@c:\pdf.pdf' 'https://wildfire.paloaltonetworks.com/publicapi/submit/file'

The XML response contains the original filename along with the SHA256 and MD5 hash:

<wildfire> 
    <upload-file-info> 
        <url></url> 
        <filetype>Adobe PDF document</filetype> 
        <filename>pdf.pdf</filename> 
        <sha256>ebb031c3945e884e695dbc63c52a5efcd075375046c49729980073585ee13c52</sha256> 
        <md5>8bd6509aba6eafe623392995b08c7047</md5> 
        <size>433994</size> 
    </upload-file-info> 
</wildfire>

Submit Files and Links through the WildFire API

Submit a Remote File to WildFire (API)