Delete authentication record

/api/2.0/fo/auth/{technology}/?action=delete

[POST]

Delete a vault in the user's account. {technology} will reflect the record type, i.e. Windows, Unix, Docker, etc.

Permissions - Managers can update vaults. Unit Managers can update vaults if they are granted the permission "Create/edit authentication records/vaults" and all hosts in the record are in the user's business unit.

Input Parameters

Parameter

Description

action=update

(Required)  

echo_request={0|1}

(Optional) Specify 1 to view (echo) input parameters in the XML output. By default these are not included.

ids={value}

(Required) IDs for authentication records you want to delete. You can enter IDs and ID ranges. Multiple entries are comma separated. Valid IDs are required.

 

Sample - Delete multiple Sybase auth records

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl Sample" -d "action=delete&ids=78187,78783-78784&echo_request=1" "https://qualysapi.qualys.com/api/2.0/fo/auth/sybase/" > file.xml

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE BATCH_RETURN SYSTEM "https://qualysapi.qualys.com/api/2.0/batch_return.dtd">

<BATCH_RETURN>

  <REQUEST>

    <DATETIME>2018-04-10T21:27:22Z</DATETIME>

    <USER_LOGIN>enter_ss</USER_LOGIN> <RESOURCE>https://qualysapi.qualys.com/api/2.0/fo/auth/sybase/</RESOURCE>

    <PARAM_LIST>

      <PARAM>

        <KEY>action</KEY>

        <VALUE>delete</VALUE>

      </PARAM>

      <PARAM>

        <KEY>ids</KEY>

        <VALUE>78187,78783-78784</VALUE>

      </PARAM>

      <PARAM>

        <KEY>echo_request</KEY>

        <VALUE>1</VALUE>

      </PARAM>

    </PARAM_LIST>

  </REQUEST>

  <RESPONSE>

    <DATETIME>2018-04-10T21:27:22Z</DATETIME>

    <BATCH_LIST>

      <BATCH>

        <TEXT>Successfully Deleted</TEXT>

        <ID_SET>

          <ID>78187</ID>

          <ID_RANGE>78783-78784</ID_RANGE>

        </ID_SET>

      </BATCH>

    </BATCH_LIST>

  </RESPONSE>

</BATCH_RETURN>

DTD

<platform API server>/api/2.0/batch_return.dtd