Skip To Content
ArcGIS Developers
Dashboard

Overview of the ArcGIS Enterprise Admin API

The Enterprise Admin Directory, which is installed with each instance of ArcGIS Enterprise on Kubernetes, is a simple HTML interface that allows you to interact with the resources and operations exposed by the Admin API.

The ArcGIS Enterprise Admin REST API allows you to perform administrative tasks through resource and operation endpoints. Resources are entities within your deployment that hold some information and have a well-defined state. Operations act on these resources and update their information or state. The resources and operations in the Admin API are hierarchical, with each endpoint having a unique universal resource locator (URL).

API Security

The Admin API supports token based authentication. In order to use the API, you must provide a token that has been acquired from the Generate Token operation in the Portal Directory (Sharing API), or log in into the Enterprise Admin Directory HTML interface of the API as a recognized administrator, which will generate a token that will be stored during the entirety of the entirety of the session.

Caution:

For security reasons, all POST requests performed from the Enterprise Admin API will need to included a token in the request body. If requests are being performed through the HTML interface of the API, the stored token, automatically generated for administrators who log in through the HTML interface, will be added as a hidden parameter for all POST requests. For those who needed to generate a token through the Sharing API, that token must be passed as the value for the token parameter in the request.

Due to the sensitive nature of information exchanged between the Admin API and its consumer, only accessing the API over an SSL connection is supported.

Getting Started

The hierarchical root of the Enterprise Admin API beings with a well-defined URL, known as the Enterprise Admin API root URL. This URL is formatted as follows:

https://organization.example.com/<context>/admin

The various resources and operations that are exposed by the API are organized hierarchically from the root URL. For example, from the root URL, administrators can manage the deployment's organizations, services, uploads, datastores, system configuration, and organization logs.

To access a resource or invoke an operation, you must do the following to create a request:

  1. Construct a URL to the selected resource or operation as defined in the API reference
  2. Provide the relevant parameters in their specified format
  3. Access the URL over the prescribed HTTPS method (either GET or POST)

The API is stateless, which means that ArcGIS Enterprise does not keeps track of transactions from one request to the next. Each request must contain all the information necessary for successful processing, ensuring that each request returns a well-defined response.

Endpoint support

There are some endpoints in the Enterprise Admin API that, though they are documented, are not supported with ArcGIS Enterprise 10.9. The documentation for these endpoints contain a note stating whether they have been deferred from the initial release or not supported. For a list of what is included with this release, see the ArcGIS Enterprise on Kubernetes help.