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

# Retrieve Mapbox Settings

> GET /mapbox/settings
> 
> Returns the server's Mapbox integration settings. The Mapbox secret key is never returned: `api_key_last4` carries its last four characters only (`null` when no key is stored, `""` when the stored key is four characters or shorter).
> 
> `map_types` lists the map types `map_type` may take. `server_mapview_limit` is the server-wide map-view cap; a negative value means no cap.
> 
> ### Authorization
> 
> Internal API clients only. On a ZWS-integrated server, COMPANY and SERVER users are allowed; on any other server, SERVER users only. The role check runs before the enabled check, so a disallowed user gets `403` even when Mapbox is disabled.



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


## Authentication methods
- Oauth2


## Parameters
### Headers

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





## Responses
### 200
OK

#### 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


### 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)
