Getting Started with Mist API
Introduction
Version: 2602.1.4
Date: February 26, 2026
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 |
| MISTGLOBAL01 |
Default |
| MISTGLOBAL02 |
- |
| MISTGLOBAL03 |
- |
| MISTGLOBAL04 |
- |
| MISTGLOBAL05 |
- |
| MISTEMEA01 |
- |
| MISTEMEA02 |
- |
| MISTEMEA03 |
- |
| MISTEMEA04 |
- |
| MISTAPAC01 |
- |
| MISTAPAC02 |
- |
| MISTAPAC03 |
- |
Authorization
This API uses the following authentication schemes.
List of APIs
Webhooks
SDK Infrastructure
Configuration
Utilities