POST Codesign/CountReferences

Returns the number of references to a signing application or a signing application collection that are currently in use within CodeSign Protect projects.

Requirements

  • Permissions:  None
  • Token scope:  Codesign

Headers

  • Content type: Content-Type:application/json.

  • Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.

Parameters

Specify either an Application or an ApplicationCollection.

Input parameters

Name

Description

Application

A signing tool which is represented by an Application object. To get this value, call POST Codesign/EnumerateApplications.

ApplicationCollection A set of signing tools which is represented by an ApplicationCollection object container that holds Application. To get this value, call POST Codesign/EnumerateApplicationCollections.

Returns

Response description

Name

Description

HTTP 200

For valid requests, this call returns a HTTP 200 message and the following data in the message body:

  • Error: Appears only when Success is false. An error message that accompanies the Result. Check your payload input values.

  • Result: The Result code of this API call. For more information, see Sign Result Codes.

  • Success: The result of this API call: A value of false indicates the request failed due to an Error. Otherwise, true.

HTTP 400

For invalid requests, this call returns HTTP 400 Bad Request and the following data in the message body:

  • error: The reason for the error.
  • error_description: If available, additional information about how to retry the request.

Example: Count the number of times a signing tool signed software

Request

POST https://codesign.venafi.example/vedsdk/CountReferences
Authorization:Bearer 4MyGeneratedBearerTknz==
{
   "Application":{
      "Dn":"\\VED\\Code Signing\\Signing Applications\\Signtool - v7.1A",
      "Guid":"{zf168386-0136-44b2-8bda-43327a7aa2c1}",
      "SignatorySubject":"Microsoft Corporation"
   }
}

Response

HTTP/1.1 200 OK
{
   "Count": 1,
   "Result":1,
   "Success":true
}