- URL:https://<license-url>/releaseLicense (10.7)
https://<licenses-url>/releaseLicense (10.3-10.6.1) - Required Capability:Default administrator role | Manage licenses privilege
- Version Introduced:10.3
Description
If a user checks out an ArcGIS Pro license for offline or disconnected use, this operation releases the license for the specified account. A license can only be used with a single device running ArcGIS Pro. To check in the license, a valid access token and refresh token is required. If the refresh token for the device is lost, damaged, corrupted, or formatted, the user will not be able to check in the license. This prevents the user from logging in to ArcGIS Pro from any other device. As an administrator, you can release the license. This frees the outstanding license and allows the user to check out a new license or use ArcGIS Pro in a connected environment.
Note:
releaseLicense has changed locations at 10.7. Previously located under the Licenses resource, this operation can now be found under License, found directly on the Portal Administration Root page.
Request parameters
Parameter | Details |
---|---|
username | The user name of the account. Example
|
f | The response format. The default response format is html. Values: html | json | pjson |
Example usage
Below is a sample POST request for releaseLicense:
POST /webadaptor/portaladmin/license/releaseLicense HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
username=jdoe&f=json
JSON Response example
{"status": "success"}