---
title: Global configuration update REST API
description: ABS provides a REST API 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:
component: pingintelligence
version: 5.1
page_id: pingintelligence:abs_ai_engine:pingintelligence_global_configuration_update_rest_api
canonical_url: https://docs.pingidentity.com/pingintelligence/5.1/abs_ai_engine/pingintelligence_global_configuration_update_rest_api.html
revdate: April 3, 2024
section_ids:
  related-links: Related links
---

# Global configuration update REST API

ABS provides a REST API 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. The 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](../pingintelligence_dashboard/pingintelligence_discovered_apis.html) in PingIntelligence Dashboard or [ABS Postman collections](ofp1564008974676.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

* [AI engine training](pingintelligence_ai_engine_training.html)

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

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

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

* [Manage discovery intervals](pingintelligence_managing_discovery_intervals.html)