> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/llms.txt)

# Update Mapbox Settings

> PUT /mapbox/settings
> 
> Updates the server's Mapbox integration settings. Every field is optional; an omitted field keeps its stored value. In particular, omit `api_key` to keep the stored key.
> 
> After the merge, `api_key`, `user` and `map_type` must all be non-empty, and `map_type` must be one of the server's `map_types`. `profile_default_threshold` must be an integer of 0 or more, unless `server_mapview_limit` is negative.
> 
> ### Authorization
> 
> Same as `GET /mapbox/settings`: internal API clients only; COMPANY or SERVER users on a ZWS-integrated server, SERVER users only otherwise.



## Servers
- https://api.iformbuilder.com/exzact/api/v81/[servername]: https://api.iformbuilder.com/exzact/api/v81/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}




### Body: application/json (object)

- **api_key** (string)
  the Mapbox secret key; omit to keep the stored key

- **user** (string)
  the Mapbox account user name

- **map_type** (string)
  the default map type; one of `map_types`

- **profile_default_threshold** (integer)
  the default map-view threshold for a new profile



## Responses
### 200
OK - the settings were saved. The body is the updated settings, in the same shape as `GET`.

#### Body: application/json (object)
- **enabled** (boolean)
  always `true`; a disabled server answers `409`

- **user** (string)
  the Mapbox account user name

- **api_key_last4** (string | null)
  the last four characters of the stored key; `null` when none is stored, `""` when the key is four characters or shorter

- **map_type** (string)
  the default map type

- **map_types** (array[string])
  the map types `map_type` may take

- **profile_default_threshold** (integer)
  the default map-view threshold for a new profile

- **server_mapview_limit** (integer)
  the server-wide map-view cap; negative means no cap


### 400
Bad Request - the body is not a JSON object, a field is empty or of the wrong type, `map_type` is not one of `map_types`, or `profile_default_threshold` is below 0 while `server_mapview_limit` is 0 or more.

### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - the client is not internal, or the user's role is not allowed (see Authorization).

### 409
Conflict - Mapbox is not enabled on this server.


[Powered by Bump.sh](https://bump.sh)
