---
title: "Runs dig command on an Appliance."
slug: "runs-dig-command-on-an-appliance-1"
updated: 2026-03-02T22:30:52Z
published: 2026-03-02T22:35:48Z
canonical: "support.appgate.com/runs-dig-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 dig command on an Appliance.

Post/appliances/{id}/command/dig

Run dig command on an Appliance. This API call must be made with **Accept** header of **application/vnd.appgate.com.peer-v20+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

Dig parameters

<select class='api-response-data' aria-label='Media type'><option value='5c1959fd-fb6c-4a63-a59c-92c40ff70a7c'>application/json</option>
</select>object  hoststring    Required

The host to query.

Exampleappgate.com
serverstring    

The DNS server to use for querying.

Example1.1.1.1
typestring    

Select DNS request type.

Valid values[
  "*",
  "A",
  "A6",
  "AAAA",
  "AFSDB",
  "AMTRELAY",
  "APL",
  "ATMA",
  "AVC",
  "AXFR",
  "CAA",
  "CDNSKEY",
  "CDS",
  "CERT",
  "CNAME",
  "CSYNC",
  "DHCID",
  "DLV",
  "DNAME",
  "DNSKEY",
  "DOA",
  "DS",
  "EID",
  "EUI48",
  "EUI64",
  "GID",
  "GPOS",
  "HINFO",
  "HIP",
  "HTTPS",
  "IPSECKEY",
  "ISDN",
  "IXFR",
  "KEY",
  "KX",
  "L32",
  "L64",
  "LOC",
  "LP",
  "MAILA",
  "MAILB",
  "MB",
  "MD",
  "MF",
  "MG",
  "MINFO",
  "MR",
  "MX",
  "NAPTR",
  "NID",
  "NIMLOC",
  "NINFO",
  "NS",
  "NSAP",
  "NSAP-PTR",
  "NSEC",
  "NSEC3",
  "NSEC3PARAM",
  "NULL",
  "NXT",
  "OPENPGPKEY",
  "OPT",
  "PTR",
  "PX",
  "RKEY",
  "RP",
  "RRSIG",
  "RT",
  "SIG",
  "SINK",
  "SMIMEA",
  "SOA",
  "SPF",
  "SRV",
  "SSHFP",
  "SVCB",
  "TA",
  "TALINK",
  "TKEY",
  "TLSA",
  "TSIG",
  "TXT",
  "UID",
  "UINFO",
  "UNSPEC",
  "URI",
  "WKS",
  "X25",
  "ZONEMD"
]Default"A"
protocolstring    

Select protocol.

Valid values[
  "UDP",
  "TCP"
]Default"UDP"
processTimeoutinteger    

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

Default5

Responses200

Command ran successfully.

<select class='api-response-data' aria-label='Media type'><option value='3f918a8f-b9ef-4e5c-baa6-6946976c37e0'>text/plain</option>
</select>string    

The dig result.

400

JSON error. Check the JSON format.

<select class='api-response-data' aria-label='Media type'><option value='f3ad9d3f-0806-40ff-8cbb-c0489a9cd8a3'>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='87aa7760-eb80-470f-bdd5-034a44d50e09'>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='6f12ee5a-c201-4d72-babb-6c24e9647472'>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='48688310-8778-49bc-a8a1-231cd2455718'>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='ff35778f-c5af-46ab-a3ad-feb5b8bf4b13'>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='fdd836ba-737a-450b-b655-5083b9eb6552'>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='b10079f5-08be-4c34-90e4-a2465b5fe5eb'>application/json</option>
</select>object  

Generic HTTP error.

idstring    

Machine readable error code.

messagestring    

Human readable error details.