auth-endpoints.mdx

title	Auth Endpoints
description	Auth Endpoints protocol schemas

{/* ⚠️ AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs go in content/docs/guides/. */}

Authentication Endpoint Specification

Defines the canonical HTTP endpoints for the authentication service.

Based on better-auth v1.4.18 endpoint conventions.

NOTE: ObjectStack's auth implementation uses better-auth library which has

established endpoint conventions. This spec documents those conventions as

the canonical API contract.

**Source:** `packages/spec/src/api/auth-endpoints.zod.ts`

TypeScript Usage

import { AuthEndpoint, AuthFeaturesConfig, AuthProviderInfo, EmailPasswordConfigPublic, GetAuthConfigResponse } from '@objectstack/spec/api';
import type { AuthEndpoint, AuthFeaturesConfig, AuthProviderInfo, EmailPasswordConfigPublic, GetAuthConfigResponse } from '@objectstack/spec/api';

// Validate data
const result = AuthEndpoint.parse(data);

---

AuthEndpoint

Properties

Property	Type	Required	Description
signInEmail	Object	✅
signUpEmail	Object	✅
signOut	Object	✅
getSession	Object	✅
forgetPassword	Object	✅
resetPassword	Object	✅
sendVerificationEmail	Object	✅
verifyEmail	Object	✅

---

AuthFeaturesConfig

Properties

Property	Type	Required	Description
twoFactor	boolean	✅	Two-factor authentication enabled
passkeys	boolean	✅	Passkey/WebAuthn support enabled
magicLink	boolean	✅	Magic link login enabled
organization	boolean	✅	Multi-tenant organization support enabled

---

AuthProviderInfo

Properties

Property	Type	Required	Description
id	string	✅	Provider ID (e.g., google, github, microsoft)
name	string	✅	Display name (e.g., Google, GitHub)
enabled	boolean	✅	Whether this provider is enabled

---

EmailPasswordConfigPublic

Properties

Property	Type	Required	Description
enabled	boolean	✅	Whether email/password auth is enabled
disableSignUp	boolean	optional	Whether new user registration is disabled
requireEmailVerification	boolean	optional	Whether email verification is required

---

GetAuthConfigResponse

Properties

Property	Type	Required	Description
emailPassword	Object	✅	Email/password authentication config
socialProviders	Object[]	✅	Available social/OAuth providers
features	Object	✅	Enabled authentication features

---