Skip to main content

​
API overview

The Vidopix UI calls a set of JSON and multipart APIs. This section documents the same endpoints used by the web app in ai-emotion-ui/src.

​
Base URL

All endpoints are relative to the environment base URL:
  • VITE_BASE_URL (front-end environment variable)
Example: 
curl "$VITE_BASE_URL/project/list/{folderId}?pageSize=10&page=1"

​
Authentication

  • Most endpoints require an access_token header.
  • Tokens are refreshed via PATCH /auth/refresh-token when a 401 occurs.
  • Auth endpoints are public (/auth/login, /auth/sign-up).
Example header: 
access_token: <your-token>

​
Content types

  • JSON requests use Content-Type: application/json.
  • Uploads (videos, surveys) use multipart/form-data.

​
Common responses

  • 401 Unauthorized triggers a refresh token flow.
  • 403 Forbidden returns when the user lacks access to a plan or asset.
  • 429 or 5xx may appear during high load or long-running analysis.
If you need a token or higher limits, contact [email protected].