---
title: "Runs tcpdump command on an Appliance."
slug: "runs-tcpdump-command-on-an-appliance-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/runs-tcpdump-command-on-an-appliance-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.appgate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs tcpdump command on an Appliance.

Post/appliances/{id}/command/tcpdump

Runs tcpdump command on an Appliance. This API call must be made with **Accept** header of **application/vnd.appgate.peer-v23+text** as it returns plain text instead of JSON.

SecurityHTTPType bearer

Path parametersidstring (uuid) Required

ID of the object.

Example12699e27-b584-464a-81ee-5b4784b6d425

Body parameters

Tcpdump parameters

<select class='api-response-data' aria-label='Media type'><option value='0321ae9d-767c-4f0d-b717-8717adad4c5f'>application/json</option>
</select>object  expressionstring    

The expression to filter tcpdump.

Exampleudp
interfacestring    

The network interface to tcpdump on.

Exampleeth0
processTimeoutinteger    

The number of seconds to run/wait before timing out.

Default30

Responses200

Command ran successfully.

<select class='api-response-data' aria-label='Media type'><option value='d4b090d3-48d2-413c-9487-d49c90403483'>text/plain</option>
</select>string    

The tcpdump result.

400

JSON error. Check the JSON format.

<select class='api-response-data' aria-label='Media type'><option value='3c074ba1-f99d-420b-8617-57b26ef925a0'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

401

Token error. Login again.

<select class='api-response-data' aria-label='Media type'><option value='c22431a7-a21f-4a79-be92-4bfb52dfd79e'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

403

Insufficient permissions to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='89489b4a-d8b5-43e8-9bd6-b8256d288734'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

406

Invalid 'Accept' header.

<select class='api-response-data' aria-label='Media type'><option value='ba7ff2e4-4f51-425a-b869-04532d7d3923'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

412

Appliance is not in the right state for this operation.

<select class='api-response-data' aria-label='Media type'><option value='3de7e77e-1b47-484b-9a8b-ce8f617c5fcc'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

422

Request validation error. Check "errors" array for details.

<select class='api-response-data' aria-label='Media type'><option value='d2790c29-9161-425e-b426-9d4d826cb53a'>application/json</option>
</select>Expand Allobject  

Http 422 error for object validation.

idstring    

Machine readable error code.

messagestring    

Human readable error details.

errors Array of object   

List of fields with validation errors.

object  fieldstring    

Name of the field that failed validation.

Examplename
messagestring    

Failure reason.

Examplemay not be null

500

Unexpected server side error.

<select class='api-response-data' aria-label='Media type'><option value='924d40b1-7925-4209-96fb-40fb9594e8a6'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.