PingOne Platform APIs

Update Credential Issuance Rule

   

PUT {{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}

Use the PUT {{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}} operation to update a credential issuance rule for the specified credential type in the specified environment.

Prerequisites

Request Model

Refer to Credential Issuance Rules data model for full property descriptions.

Property Type Required?

automation

Object

Required

automation.issue

String

Required

automation.revoke

String

Required

automation.update

String

Required

digitalWalletApplication.id

String

Optional

filter

Object

Optional

filter.groupIds

String[]

Required/Optional

filter.populationIds

String[]

Required/Optional

filter.scim

String

Required/Optional

notification

Object

Optional

notification.template

Object

Optional

notification.template.locale

String

Required

notification.template.variant

String

Required

notification.template.variables

Object[]

Required/Optional

status

String

Required

If you change:

  • filter - The service stages changes to credentials affected. The service issues new credentials to users added by the change to the filter and revokes credentials of users removed by the change to the filter.

  • automation - The service reviews existing staged changes and either schedules them for the next periodic run (ON_DEMAND to PERIODIC) or de-schedules them (PERIODIC to ON_DEMAND).

  • digitalWalletApplication.id - Credentials are not affected.

When an action in automation is set to PERIODIC and the period arrives, the credential service uses a notification template appropriate to the action, credential_issued, credential_updated, or credential_revoked, to send notice of the action taken to the user via email or SMS text. The notification.template object can define a variant and locale for the notifications, if needed, and applies to actions initiated periodically and actions initiated by an Apply Credential Issuance Rule Staged Changes request.

The notification.template object applies a variant and locale to all three credential notification templates: credential_issued, credential_updated, and credential_revoked. When adding a variant or locale to any of the three notification templates, consider adding the same variant or locale to the other notification templates. If a matching variant is not defined, the default notification template is used. If a locale is not defined the notification template uses the user’s preferred language or, if the user has no preferred language, the default language of the environment.

Headers

Authorization      Bearer {{accessToken}}

Content-Type      application/json

Body

raw ( application/json )

{
    "status": "ACTIVE",
    "digitalWalletApplication": {
        "id": "{{digitalWalletApplicationID}}"
    },
    "filter": {
        "populationIds": [
            "{{popID}}"
        ]
    },
    "automation": {
        "issue": "ON_DEMAND",
        "update": "ON_DEMAND",
        "revoke": "ON_DEMAND"
    }
}

Example Request

  • cURL

  • C#

  • Go

  • HTTP

  • Java

  • jQuery

  • NodeJS

  • Python

  • PHP

  • Ruby

  • Swift

curl --location --globoff --request PUT '{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{accessToken}}' \
--data '{
    "status": "ACTIVE",
    "digitalWalletApplication": {
        "id": "{{digitalWalletApplicationID}}"
    },
    "filter": {
        "populationIds": [
            "{{popID}}"
        ]
    },
    "automation": {
        "issue": "ON_DEMAND",
        "update": "ON_DEMAND",
        "revoke": "ON_DEMAND"
    }
}'
var options = new RestClientOptions("{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("", Method.Put);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Authorization", "Bearer {{accessToken}}");
var body = @"{" + "\n" +
@"    ""status"": ""ACTIVE""," + "\n" +
@"    ""digitalWalletApplication"": {" + "\n" +
@"        ""id"": ""{{digitalWalletApplicationID}}""" + "\n" +
@"    }," + "\n" +
@"    ""filter"": {" + "\n" +
@"        ""populationIds"": [" + "\n" +
@"            ""{{popID}}""" + "\n" +
@"        ]" + "\n" +
@"    }," + "\n" +
@"    ""automation"": {" + "\n" +
@"        ""issue"": ""ON_DEMAND""," + "\n" +
@"        ""update"": ""ON_DEMAND""," + "\n" +
@"        ""revoke"": ""ON_DEMAND""" + "\n" +
@"    }" + "\n" +
@"}";
request.AddStringBody(body, DataFormat.Json);
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}"
  method := "PUT"

  payload := strings.NewReader(`{
    "status": "ACTIVE",
    "digitalWalletApplication": {
        "id": "{{digitalWalletApplicationID}}"
    },
    "filter": {
        "populationIds": [
            "{{popID}}"
        ]
    },
    "automation": {
        "issue": "ON_DEMAND",
        "update": "ON_DEMAND",
        "revoke": "ON_DEMAND"
    }
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer {{accessToken}}")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
PUT /environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}} HTTP/1.1
Host: {{apiPath}}
Content-Type: application/json
Authorization: Bearer {{accessToken}}

{
    "status": "ACTIVE",
    "digitalWalletApplication": {
        "id": "{{digitalWalletApplicationID}}"
    },
    "filter": {
        "populationIds": [
            "{{popID}}"
        ]
    },
    "automation": {
        "issue": "ON_DEMAND",
        "update": "ON_DEMAND",
        "revoke": "ON_DEMAND"
    }
}
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n    \"status\": \"ACTIVE\",\n    \"digitalWalletApplication\": {\n        \"id\": \"{{digitalWalletApplicationID}}\"\n    },\n    \"filter\": {\n        \"populationIds\": [\n            \"{{popID}}\"\n        ]\n    },\n    \"automation\": {\n        \"issue\": \"ON_DEMAND\",\n        \"update\": \"ON_DEMAND\",\n        \"revoke\": \"ON_DEMAND\"\n    }\n}");
Request request = new Request.Builder()
  .url("{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}")
  .method("PUT", body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Authorization", "Bearer {{accessToken}}")
  .build();
Response response = client.newCall(request).execute();
var settings = {
  "url": "{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}",
  "method": "PUT",
  "timeout": 0,
  "headers": {
    "Content-Type": "application/json",
    "Authorization": "Bearer {{accessToken}}"
  },
  "data": JSON.stringify({
    "status": "ACTIVE",
    "digitalWalletApplication": {
      "id": "{{digitalWalletApplicationID}}"
    },
    "filter": {
      "populationIds": [
        "{{popID}}"
      ]
    },
    "automation": {
      "issue": "ON_DEMAND",
      "update": "ON_DEMAND",
      "revoke": "ON_DEMAND"
    }
  }),
};

$.ajax(settings).done(function (response) {
  console.log(response);
});
var request = require('request');
var options = {
  'method': 'PUT',
  'url': '{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}',
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer {{accessToken}}'
  },
  body: JSON.stringify({
    "status": "ACTIVE",
    "digitalWalletApplication": {
      "id": "{{digitalWalletApplicationID}}"
    },
    "filter": {
      "populationIds": [
        "{{popID}}"
      ]
    },
    "automation": {
      "issue": "ON_DEMAND",
      "update": "ON_DEMAND",
      "revoke": "ON_DEMAND"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
import requests
import json

url = "{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}"

payload = json.dumps({
  "status": "ACTIVE",
  "digitalWalletApplication": {
    "id": "{{digitalWalletApplicationID}}"
  },
  "filter": {
    "populationIds": [
      "{{popID}}"
    ]
  },
  "automation": {
    "issue": "ON_DEMAND",
    "update": "ON_DEMAND",
    "revoke": "ON_DEMAND"
  }
})
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'Bearer {{accessToken}}'
}

response = requests.request("PUT", url, headers=headers, data=payload)

print(response.text)
<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}');
$request->setMethod(HTTP_Request2::METHOD_PUT);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
$request->setHeader(array(
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {{accessToken}}'
));
$request->setBody('{\n    "status": "ACTIVE",\n    "digitalWalletApplication": {\n        "id": "{{digitalWalletApplicationID}}"\n    },\n    "filter": {\n        "populationIds": [\n            "{{popID}}"\n        ]\n    },\n    "automation": {\n        "issue": "ON_DEMAND",\n        "update": "ON_DEMAND",\n        "revoke": "ON_DEMAND"\n    }\n}');
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
require "uri"
require "json"
require "net/http"

url = URI("{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Put.new(url)
request["Content-Type"] = "application/json"
request["Authorization"] = "Bearer {{accessToken}}"
request.body = JSON.dump({
  "status": "ACTIVE",
  "digitalWalletApplication": {
    "id": "{{digitalWalletApplicationID}}"
  },
  "filter": {
    "populationIds": [
      "{{popID}}"
    ]
  },
  "automation": {
    "issue": "ON_DEMAND",
    "update": "ON_DEMAND",
    "revoke": "ON_DEMAND"
  }
})

response = http.request(request)
puts response.read_body
let parameters = "{\n    \"status\": \"ACTIVE\",\n    \"digitalWalletApplication\": {\n        \"id\": \"{{digitalWalletApplicationID}}\"\n    },\n    \"filter\": {\n        \"populationIds\": [\n            \"{{popID}}\"\n        ]\n    },\n    \"automation\": {\n        \"issue\": \"ON_DEMAND\",\n        \"update\": \"ON_DEMAND\",\n        \"revoke\": \"ON_DEMAND\"\n    }\n}"
let postData = parameters.data(using: .utf8)

var request = URLRequest(url: URL(string: "{{apiPath}}/environments/{{envID}}/credentialTypes/{{credentialTypeID}}/issuanceRules/{{credentialIssuanceRuleID}}")!,timeoutInterval: Double.infinity)
request.addValue("application/json", forHTTPHeaderField: "Content-Type")
request.addValue("Bearer {{accessToken}}", forHTTPHeaderField: "Authorization")

request.httpMethod = "PUT"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Example Response

200 OK

{
    "_links": {
        "self": {
            "href": "https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/credentialTypes/8a3a6157-5fb9-40b7-96c0-909331858248/issuanceRules/7888a5ed-ae7b-482c-973d-afd27973099c"
        }
    },
    "id": "7888a5ed-ae7b-482c-973d-afd27973099c",
    "createdAt": "2023-03-01T20:29:51.912Z",
    "updatedAt": "2023-03-02T15:01:48.575Z",
    "environment": {
        "id": "abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"
    },
    "credentialType": {
        "id": "8a3a6157-5fb9-40b7-96c0-909331858248"
    },
    "status": "ACTIVE",
    "digitalWalletApplication": {
        "id": "6815c8a6-bc0b-4105-8f37-50f6c35583d7"
    },
    "filter": {
        "populationIds": [
            "e85091a0-ddca-422e-935e-d1faf139df3d"
        ]
    },
    "automation": {
        "issue": "ON_DEMAND",
        "update": "ON_DEMAND",
        "revoke": "ON_DEMAND"
    }
}