Namespace API & SDK

Namespace exposes a public API to allow building integrations on top of our platform. In addition to our detailed API Documentation, there are ready-to-use SDKs for over 15 languages.

API Documentation

Our API documentation can be found at buf.build/namespace/cloud. It details what endpoints to use, and how to authenticate to them. For each service, available procedures as well as their request and response types are listed:

Screenshot of available procedures for the Builders service of Namespaces API

When clicking through to a request or response type, the contents of this type are described. All available fields including their types and intended use are displayed:

Screenshot of the field descriptions of a request and response message

IAM integration

In order to create and manage multiple workspaces programatically, you can integrate with Namespace IAM. Namespace relies on trust relationships using public-key cryptography and the OpenID Connect standard to verify the tokens instead of pre-shared keys which are more easily compromised.

SDKs

Go SDK

Namespace maintains an SDK for use in Go projects that provides ready-to-use clients including authentication and examples. The Go implementation is the most mature SDK and is used in production by multiple integrations.

The Go SDK can be found at github.com/namespacelabs/integrations

Other languages

For many languages, generated SDKs are available to quickly get started with Namespaces API. These SDKs include all available procedures and request/response types to support autocompletion in your IDE.

SDKs are available for many languages including Go, Python, Javascript, TypeScript, Rust, and more.

To get started, visit the SDKs page and install the SDK for your language.

Some of the SDKs available for Namespaces API — Some of the available SDKs