Quickstart

The MOI SDK gives applications access to the MOI Catalog Service. The official Python and Go implementations both expose two client layers:

• RawClient maps directly to service operations such as querying the Catalog, managing data objects, and working with tasks.

• SDKClient builds on RawClient and provides higher-level workflows for file imports, table-access roles, and SQL execution.

To call the Genesis model API, use the Genesis Model API instead. To query a database over the MySQL protocol, see SQL Connection String. Neither connection uses the SDK described in this section.

What you need

Obtain these values from your MOI deployment or administrator before running an example:

Setting	Description
Base URL	Root URL of the Catalog Service, including http:// or https://. The SDK does not contain a default public endpoint.
SDK API Key	A key accepted by the Catalog Service. The SDK sends it in the moi-key request header.
Resource access	The identity associated with the key needs at least read access to the resources used by the example.

Do not put the key in source code or commit it to version control. Both language guides read configuration from environment variables.

Choose a language

Language	Runtime	Installation source	Guide
Python	Python 3.9 or later	Official GitHub repository	Python SDK Quickstart
Go	Go 1.24.3 or a later version compatible with the SDK’s go.mod	Go module	Go SDK Quickstart

Both guides use the read-only catalog-list operation for the first request, so running the example does not change workspace resources. After the connection and credentials work, use RawClient for individual resource operations or SDKClient for its higher-level helpers.