juanfont/headscale · error

creating oauth client: %w

Error message

creating oauth client: %w

What it means

Error "creating oauth client: %w" thrown in juanfont/headscale.

Source

Thrown at cmd/headscale/cli/oauth_client.go:81

			return fmt.Errorf("at least one --scope is required: %w", errMissingParameter)
		}

		ctx, client, cancel, err := newV2Client()
		if err != nil {
			return err
		}
		defer cancel()

		keyType := "client"

		resp, err := client.CreateKeyWithResponse(ctx, oauthTailnet, clientv2.CreateKeyRequest{
			KeyType:     &keyType,
			Scopes:      &scopes,
			Tags:        &tags,
			Description: &description,
		})
		if err != nil {
			return fmt.Errorf("creating oauth client: %w", err)
		}

		err = v2Error(resp.HTTPResponse.StatusCode, resp.Body)
		if err != nil {
			return err
		}

		key := resp.JSON200

		return printOutput(cmd, key,
			fmt.Sprintf("OAuth client %s created.\nSecret (shown once, store it now): %s", key.Id, ptrStr(key.Key)))
	},
}

var listOAuthClientsCmd = &cobra.Command{
	Use:     cmdList,
	Short:   "List OAuth clients",
	Aliases: []string{"ls", cmdShow},

View on GitHub (pinned to 565fd254d0)

Solutions

1. Inspect the wrapped error for the underlying cause and correct the failing condition (creating oauth client); retry the operation after fixing the input, configuration, or environment.

Example fix

Inspect the wrapped error for the underlying cause and correct the failing condition (creating oauth client); retry the operation after fixing the input, configuration, or environment.

When it happens

Trigger: Thrown at cmd/headscale/cli/oauth_client.go:81 when the library encounters an invalid state.

Common situations: The gRPC CreateOAuthClient call failed. Check the server connection and that the requested scopes and redirect URIs are acceptable.

AI-assisted analysis of juanfont/headscale@565fd254d0 (2026-08-15). Data as JSON: /api/errors/ed9816625ca1ccd8. Report an issue: GitHub.