v1.0.0

This is the first stable release of the Auth0 MyOrganization Go SDK. It promotes v1.0.0-beta.0 to a stable v1.0.0, with new APIs for managing organization members, roles, memberships, and invitations.

Installation

go get github.com/auth0/myorganization-go

Requirements: Go 1.25+

What's New

• Members - List and get organization members with cursor-based pagination via Organization.Members
• Member Roles - List, assign, and unassign roles for a member via Organization.Members.Roles
• Roles - List organization roles via Organization.Roles
• Memberships - Remove organization memberships via Organization.Memberships
• Invitations - Full lifecycle (list, create, get, delete) for member invitations via Organization.Invitations
• Member-specific typed error codes in organization/members/error_codes.go

Maintenance

• Bump the Go toolchain to go1.25.11 to clear four standard library advisories reported by govulncheck (GO-2026-5039, GO-2026-5037, GO-2026-4971, GO-2026-4918)

v1.0.0-beta.0

This is the first beta release of the Auth0 MyOrganization Go SDK, providing a fully-featured Go client for managing Auth0 Organizations.

Installation

go get github.com/auth0/myorganization-go

Requirements: Go 1.25+

Usage

import (
    "context"

    "github.com/auth0/myorganization-go/client"
    "github.com/auth0/myorganization-go/option"
)

c, err := client.New(
    "mytenant.auth0.com",
    option.WithClientCredentials(
        context.Background(),
        "<YOUR_CLIENT_ID>",
        "<YOUR_CLIENT_SECRET>",
    ),
)

Authentication

• Client Credentials (M2M) with automatic token caching and refresh via option.WithClientCredentials
• Private Key JWT using signed JWT assertions (RS256, PS256, ES256, and more) via option.WithPrivateKeyJWT
• Custom Token Source for full control over token management via option.WithTokenSource
• Static Token for pre-existing bearer tokens via option.WithStaticToken

Supported APIs

• Organization Details - Get and update organization details, display name, and branding
• Organization Configuration - Retrieve API configuration and connection profile settings
• Domains - List, create, get, delete, and verify organization domains with cursor-based pagination
• Identity Providers - Full lifecycle management including create, update, delete, detach, and attribute refresh
• Identity Provider Domains - Associate and remove verified domains from identity providers
• Provisioning - Manage provisioning configurations and SCIM tokens (list, create, revoke)

SDK Features

• Automatic retry with exponential backoff on 408, 429, and 5XX (default: 2 attempts, configurable via option.WithMaxAttempts)
• Configurable streaming buffer size via option.WithMaxStreamBufSize
• Typed error handling with BadRequestError, UnauthorizedError, ForbiddenError, NotFoundError, and TooManyRequestsError
• Raw HTTP response access via WithRawResponse for status codes, headers, and rate limit info
• Explicit null values in JSON payloads using Set* methods
• Request-level option overrides for per-call configuration
• Debug logging with automatic sensitive header redaction via option.WithDebug
• Telemetry via Auth0-Client header (opt-out with option.WithNoAuth0ClientInfo)

For usage examples, see examples.md. For full API reference, see reference.md.