Getting Started with Mist API
Introduction
Version: 2511.1.8
Date: December 18, 2025
NOTE:
Some important API changes will be introduced. Please make sure to read the
announcements
Additional Documentation
Helpful Resources
Mist Web Browser Extension:
Requirements
The SDK requires Go version 1.18 or above.
Building
Install Dependencies
Resolve all the SDK dependencies, using the go get command.
Installation
The following section explains how to use the mistapi library in a new project.
1. Add SDK as a Dependency to the Application
- Add the following lines to your application's
go.mod file:
replace mistapi => ".\\mist-api-go_generic_lib" // local path to the SDK
require mistapi v0.0.0
- Resolve the dependencies in the updated
go.mod file, using the go get command.
Test the SDK
Go Testing is used as the testing framework. To run the unit tests of the SDK, navigate to the root directory of the SDK and run the following command in the terminal:
$ go test
Initialize the API Client
Note: Documentation for the client can be found here.
The following parameters are configurable for the API Client:
| Parameter |
Type |
Description |
| accept |
string |
Default: "application/json, application/vnd.api+json" |
| environment |
Environment |
The API environment. Default: Environment.MIST_GLOBAL_01 |
| httpConfiguration |
HttpConfiguration |
Configurable http client options like timeout and retries. |
| loggerConfiguration |
LoggerConfiguration |
Represents the logger configurations for API calls |
| apiTokenCredentials |
ApiTokenCredentials |
The Credentials Setter for Custom Header Signature |
| basicAuthCredentials |
BasicAuthCredentials |
The Credentials Setter for Basic Authentication |
| csrfTokenCredentials |
CsrfTokenCredentials |
The Credentials Setter for Custom Header Signature |
The API client can be initialized as follows:
package main
import (
"mistapi"
)
func main() {
client := mistapi.NewClient(
mistapi.CreateConfiguration(
mistapi.WithHttpConfiguration(
mistapi.CreateHttpConfiguration(
mistapi.WithTimeout(0),
),
),
mistapi.WithEnvironment(mistapi.MIST_GLOBAL_01),
mistapi.WithApiTokenCredentials(
mistapi.NewApiTokenCredentials("Authorization"),
),
mistapi.WithBasicAuthCredentials(
mistapi.NewBasicAuthCredentials(
"Username",
"Password",
),
),
mistapi.WithCsrfTokenCredentials(
mistapi.NewCsrfTokenCredentials("X-CSRFToken"),
),
mistapi.WithAccept("application/json, application/vnd.api+json"),
mistapi.WithLoggerConfiguration(
mistapi.WithLevel("info"),
mistapi.WithRequestConfiguration(
mistapi.WithRequestBody(true),
),
mistapi.WithResponseConfiguration(
mistapi.WithResponseHeaders(true),
),
),
),
)
}
Environments
The SDK can be configured to use a different environment for making API calls. Available environments are:
Fields
| Name |
Description |
| Mist Global 01 |
Default |
| Mist Global 02 |
- |
| Mist Global 03 |
- |
| Mist Global 04 |
- |
| Mist Global 05 |
- |
| Mist EMEA 01 |
- |
| Mist EMEA 02 |
- |
| Mist EMEA 03 |
- |
| Mist EMEA 04 |
- |
| Mist APAC 01 |
- |
| Mist APAC 02 |
- |
| Mist APAC 03 |
- |
Authorization
This API uses the following authentication schemes.
List of APIs
Webhooks
SDK Infrastructure
Configuration
Utilities