Request Structure

API: /certificate/revoke

Method: PUT

URL: https://<APPVIEWX_GATEWAY_IP>:<APPVIEWX_GATEWAY_PORT>/avxapi/certificate/revoke?gwkey=f000ca01&gwsource=external&isSync=true&ttl=300

Name

Type

Mandatory

Field Type

Description

Constraints

userName

Header

Yes

String

Username that is configured in AppViewX.

password

Header

Yes

String

Password of that user.

content-type

Header

Yes

String

Payload content-type with application/json value.

The value must be application/json.

gwkey

Queryparam

Yes

String

Tenant Key. This is needed only in case of multi tenant installations and can be ignored in other type of installations.

gwsource

Queryparam

Yes

String

Source, from which the request is triggered. For example, external.

isSync

Queryparam

No

boolean

The possible values are true and false. If you want to use sync API, set the value as true. If you want to use the async API, set the value as false.

Note: Default value is false.

Must be a valid boolean value: true or false.

ttl

Queryparam

No

Int

Time to live for a response in seconds. Default value is 300 seconds. Must be a positive integer.

Body

Body

Yes

json

Refer to the sample request body.

SyncRevokeRequest
Name

Mandatory

Description

Field Type

Constraints

resourceId

Yes

Mongo Id of the certificate in the AppViewX database.

Note: It refers to the ‘resourceId’ field in the create certificate response. It can be found using the search API using commonName, serial No. or other search parameters.

String

Either resourceId or serialNumber and commonName is mandatory.

commonName

Yes

Common name of the certificate.

String

serialNumber Yes Serial number of the certificate. String
reason Yes Reason for revoke. String
comments Yes Comments for Revocation String Comments field is mandatory for some revoke reasons alone. Refer Valid Reason for CAs table.
Valid Reason for CAs

Certificate Authority

Reasons

Comments Required

Entrust

Superseded

No

Cessation of operation

No

Affiliation Changed

No

Key compromised

Yes