---
title: Global configuration update REST API
description: API Behavioral Security (ABS) provides a REST application programming interface (API) to update global configurations related to ABS AI engine.
component: pingintelligence
version: 5.2
page_id: pingintelligence:pingintelligence_reference_guide:pingintelligence_global_configuration_update_rest_api
canonical_url: https://docs.pingidentity.com/pingintelligence/5.2/pingintelligence_reference_guide/pingintelligence_global_configuration_update_rest_api.html
revdate: April 3, 2024
section_ids:
  related-links: Related links
---

# Global configuration update REST API

API Behavioral Security (ABS) provides a REST application programming interface (API) *(tooltip: \<div class="paragraph">
\<p>A specification of interactions available for building software to access an application or service.\</p>
\</div>)* to update global configurations related to ABS AI engine.

The updated global configuration values take effect immediately. Following is the list of global configurations that you can update using the `globalconfig` API:

* `attack_initial_training`

* `attack_update_interval`

* `api_discovery`

* `discovery_initial_period`

* `discovery_subpath`

* `discovery_update_interval`

* `poc`

  |   |                                                                                                                                                                                                                                                                                                                                                                                                   |
  | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  |   | The `poc` variable is used to set the ABS AI engine in [POC (proof-of-concept) mode](pingintelligence_abs_poc_mode.html) to demonstrate the capabilities of the AI engine. In a production environment the value is always set to `false`. It is recommended not to switch the mode in production environment. If you must change the ABS AI engine to `poc` mode, contact PingIndentity support. |

* `url_limit`

* `response_size`

* `continous_learning`

* `attack_list_count`

* `root_api_attack`

* `session_inactivity_duration`

You can use the `globalconfig` API with GET and PUT methods. Following is the URL for `globalconfig` API. Only the Admin user can use the PUT method to update the values. For more information on different ABS users, see [ABS users for API reports](pingintelligence_abs_users_api_reports.html).

URL - https//*\<abs\_host>*:*\<abs\_port>*/v5/abs/globalconfig

|            | Header     | Value                                                                                                            |
| ---------- | ---------- | ---------------------------------------------------------------------------------------------------------------- |
| Access Key | `x-abs-ak` | *\<string>*For example, `abs_ak` or the value of the access key that you configured at the time of installation. |
| Secret Key | `x-abs-sk` | *\<string>*For example, `abs_sk` or the value of the secret key that you configured at the time of installation. |

When you use the `globalconfig` API with GET method, it fetches the current value of the global configuration.

```json
{
    "company": "ping identity",
    "name": "api_globalconfig",
    "description": "This report contains status information of ABS global configurations",
    "global_config": {
        "attack_initial_training": 2,
        "attack_update_interval": 1,
        "api_discovery": true,
        "discovery_initial_period": 100,
        "discovery_subpath": 3,
        "discovery_update_interval": 1,
        "poc": false,
        "url_limit": 120,
        "response_size": 150,
        "continuous_learning": false,
        "attack_list_count": 400000,
        "root_api_attack": true,
        "session_inactivity_duration": 10
    }
}
```

You can update the global configuration values that the API fetched using the PUT method. Provide the new values in the body as shown in the example below.

```json
{
    "api_discovery": true,
    "discovery_initial_period": 1
    "discovery_update_interval": 1
 }
```

```json
{
    "success": "global config updated successfully"
}
```

You can update either one or more than one global configurations at once. Note that the values are updated only when the body of the request is well-formed.

|   |                                                                                                                                                                                                                                                                                                                                                  |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|   | You can also update the global configurations using [Discovered APIs](../managing_pingintelligence_for_apis/pingintelligence_discovered_apis.html) in PingIntelligence Dashboard or [ABS Postman collections](pingintelligence_abs_reports_postman.html). However, you can only change the following variables using PingIntelligence Dashboard: |

* `attack_initial_training`

* `attack_update_interval`

* `api_discovery`

* `discovery_initial_period`

* `discovery_subpath`

* `discovery_update_interval`

## Related links

* [Managing AI engine training](../managing_pingintelligence_for_apis/pingintelligence_managing_ai_engine_training.html)

* [AI engine training variables](../managing_pingintelligence_for_apis/pingintelligence_ai_engine_training_variables.html)

* [Update the training variables](../managing_pingintelligence_for_apis/pingintelligence_update_training_variables.html)

* [API discovery and configuration](../managing_pingintelligence_for_apis/pingintelligence_api_discovery_configuration.html)

* [Managing discovery intervals](../managing_pingintelligence_for_apis/pingintelligence_managing_discovery_intervals.html)