Using Deepgram Management API from the Go SDK

When to use this product

Use this skill for admin and account operations in pkg/client/manage and pkg/api/manage/v1.

• projects
• API keys
• members and scopes
• invitations
• usage and request history
• balances
• model discovery

Use a different skill when:

• you need live voice sessions (deepgram-go-voice-agent)
• you need SDK maintenance workflow (deepgram-go-maintaining-sdk)

Authentication

Set DEEPGRAMAPIKEY before constructing the management client.

export DEEPGRAM_API_KEY="your_api_key"

Quick start

package main

import (
	"context"
	"fmt"
	"log"

	api "github.com/deepgram/deepgram-go-sdk/v3/pkg/api/manage/v1"
	manage "github.com/deepgram/deepgram-go-sdk/v3/pkg/client/manage"
)

func main() {
	if err := run(); err != nil {
		log.Fatal(err)
	}
}

func run() error {
	ctx := context.Background()

	client := manage.NewWithDefaults()
	mg := api.New(client)

	projects, err := mg.ListProjects(ctx)
	if err != nil {
		return err
	}

	fmt.Println(projects)
	return nil
}

Key parameters

• constructors

- manage.NewWithDefaults() - manage.New(apiKey, options)

• common API groups in pkg/api/manage/v1, usually via api.New(client)

- projects: ListProjects, GetProject, UpdateProject, DeleteProject - keys: ListKeys, GetKey, CreateKey, DeleteKey - members: ListMembers, RemoveMember - scopes: GetMemberScopes, UpdateMemberScopes - invitations: ListInvitations, SendInvitation, DeleteInvitation, LeaveProject - usage: ListRequests, GetRequest, GetFields, GetUsage - balances: ListBalances, GetBalance - models: ListModels, GetModels, GetModel, ListProjectModels, GetProjectModels, GetProjectModel

• low-level escape hatch

- managev1.Client.APIRequest(...)

API reference (layered)

1. In-repo reference

- README.md - docs.go - pkg/client/manage/client.go - pkg/client/manage/v1/client.go - pkg/api/manage/v1/projects.go - pkg/api/manage/v1/keys.go - pkg/api/manage/v1/members.go - pkg/api/manage/v1/scopes.go - pkg/api/manage/v1/invitations.go - pkg/api/manage/v1/usage.go - pkg/api/manage/v1/balances.go - pkg/api/manage/v1/models.go

1. OpenAPI

- https://developers.deepgram.com/openapi.yaml

1. AsyncAPI

- https://developers.deepgram.com/asyncapi.yaml

1. Context7

- /llmstxt/developersdeepgramllms_txt

1. Product docs

- https://developers.deepgram.com/reference/manage/projects/list - https://developers.deepgram.com/reference/manage/models/list

Gotchas

1. The management client is for account/admin APIs, not live Voice Agent runtime.
2. The repo exposes management operations from pkg/api/manage/v1; use api.New(client) before calling helpers like ListProjects.
3. For unsupported convenience helpers, fall back to APIRequest(...) rather than inventing a new transport layer.

Example files in this repo

• examples/manage/projects/main.go
• examples/manage/keys/main.go
• examples/manage/models/main.go
• examples/manage/usage/main.go

Central product skills

For cross-language Deepgram product knowledge — the consolidated API reference, documentation finder, focused runnable recipes, third-party integration examples, and MCP setup — install the central skills:

npx skills add deepgram/skills

This SDK ships language-idiomatic code skills; deepgram/skills ships cross-language product knowledge (see api, docs, recipes, examples, starters, setup-mcp).