API Reference

Base URL

Use your assigned hosted API URL.

Example:

https://api.your-psychai-domain.com

Creates a user if email is not already registered.

Request body:

{
  "email": "user@example.com",
  "name": "Jane Doe",
  "password": "securePassword123",
  "user_type": "developer",
  "industry": "mental_health"
}

Success:

{
  "message": "User registered successfully"
}

Request body:

{
  "email": "user@example.com",
  "password": "securePassword123"
}

Response:

{
  "access_token": "<jwt>",
  "refresh_token": "<jwt>",
  "user_id": "<uuid>",
  "tier": "Free",
  "expires_in": 3600
}

Request body:

{
  "refresh_token": "<jwt>"
}

Response:

{
  "access_token": "<jwt>",
  "refresh_token": "<jwt>"
}

Request body:

{
  "refresh_token": "<jwt>"
}

Response:

{
  "message": "Logged out successfully."
}

{
  "email": "user@example.com"
}

Response always uses a generic message for privacy:

{
  "message": "If the email exists in our system, a password reset link has been sent."
}

Returns:

{
  "valid": true
}

or

{
  "valid": false,
  "reason": "invalid"
}

{
  "token": "<reset-token>",
  "new_password": "newPassword123"
}

Headers:

Authorization: Bearer <access_token>
Content-Type: application/json

Query params:

Allowed mode values:

Request body:

{
  "input_text": "I have been overwhelmed at work but I am trying to respond more calmly."
}

Response headers include:

See Response Schema for mode-specific payload shapes.

Response shape:

{
  "app_status": "ok",
  "openai_status": "ok",
  "redis_status": "ok",
  "database_status": "ok"
}

If any dependency check fails, app_status becomes degraded.