Public docs

App Auth — Signup / Login

Create accounts and authenticate dashboard users.

Phase 1 shell: this docs surface is wired to the existing backend and repo documentation, and will be expanded as the private dashboard comes online.

Overview

These endpoints handle user registration and sign-in for the opSentry dashboard. They do not use X-API-Key — they return a user object that is stored client-side.

---

POST /app-auth/signup

Create a new user account and workspace.

Request body

{
  "email":         "you@company.com",
  "password":      "your_password",
  "full_name":     "Your Name",
  "type":          "individual" | "business",
  "business_name": "Acme Corp (required if type is business)"
}

Response

{
  "success": true,
  "user": {
    "user_id":        1,
    "email":          "you@company.com",
    "full_name":      "Your Name",
    "workspace_id":   1,
    "workspace_name": "Your Name's Workspace"
  }
}

---

POST /app-auth/login

Sign in with email and password.

Request body

{
  "email":    "you@company.com",
  "password": "your_password"
}

Response

Same shape as signup. Store the returned user object in localStorage as opsentry_user to maintain your session. The dashboard uses workspace_id from this object to scope all subsequent requests.

Error responses

  • 400 — missing fields
  • 401 — invalid email or password
  • 500 — server error
Sign up
curl -X POST https://api.opsentry.ai/app-auth/signup \
-H "Content-Type: application/json" \
-d '{
"email": "you@company.com",
"password": "securepassword",
"full_name": "Alex Johnson",
"type": "business",
"business_name": "Northstar Bank"
}'