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

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

Response

json
{
"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

json
{
"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"
}'