Auth SDK for GOLang

The IONOS Cloud SDK Auth for GO provides you with access to the IONOS Cloud Auth API. Use the Auth API to manage tokens for secure access to IONOS Cloud APIs (Auth API, Cloud API, Reseller API, Activity Log API, and others).


This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.
  • API version: 1.0
  • Package version: 1.0.0
  • Build package: org.openapitools.codegen.languages.GoClientCodegen

Getting Started

An IONOS account is required for access to the Cloud API; credentials from your registration are used to authenticate against the IONOS Cloud API.


Install the Go language from the official Go installation guide.
Install the following dependencies:
go get
go get
go get
go get
Put the package under your project folder by adding it to the go.mod:
require ""
You can get the package locally using:
go get ""


The username and password or the authentication token can be manually specified when initializing the sdk client:
client := ionossdk.NewAPIClient(ionossdk.NewConfiguration(username, password, token, hostUrl))
Environment variables can also be used. The sdk uses the following variables:
  • IONOS_USERNAME - to specify the username used to log in
  • IONOS_PASSWORD - to specify the password
  • IONOS_TOKEN - if an authentication token is being used
  • IONOS_API_URL - to specify the API endpoint in order to overwrite it
In this case, the client configuration needs to be initialized using NewConfigurationFromEnv()
client := ionossdk.NewAPIClient(ionossdk.NewConfigurationFromEnv())

Environment Variables

Environment Variable
Specify the username used to login, to authenticate against the IONOS Cloud API
Specify the password used to login, to authenticate against the IONOS Cloud API
Specify the token used to login, if a token is being used instead of username and password
Specify the API URL. It will overwrite the API endpoint default value Note: the host URL does not contain the /cloudapi/v5 path, so it should not be included in the IONOS_API_URL environment variable

Documentation for API Endpoints

All paths are relative to


HTTP request
Get /tokens/generate
Create new tokens
Delete /tokens
Delete tokens by criteria
Delete /tokens/{tokenId}
Delete tokens
Get /tokens
List all tokens
Get /tokens/{tokenId}
Get tokens by Key ID

Documentation For Models


  • How can I open a bug report/feature request?
Bug reports and feature requests can be opened in the Issues repository:
  • Can I contribute to the GO SDK for Auth API?
Pure SDKs are automatically generated using OpenAPI Generator and don’t support manual changes. If you require changes, please open an issue, and we will try to address it.
Last modified 1yr ago