Managing All Sessions
Overall Session Management
Response Structure
{
"sessions": {
"<session_id>": {
"created_at": {
"date": "DD/MM/YYYY",
"time": "HH:MM AM/PM"
},
"video_url": "...",
"segments": <number>,
"analyzed_video_url": "...",
"activity": "...",
"title": "...",
"user_id": "...",
"user_name": "...",
"report_comments": {...},
"metrics": {...}
// other session fields
},
"...": {...}
}
}Error Handling
Security
Enter your bearer token (Firebase auth) in the format: Bearer
User sessions retrieved successfully.
Bad Request - Invalid parameters or missing token.
Unauthorized - The token is missing or invalid.
Forbidden - The user lacks the required privileges.
Not Found - Sessions could not be retrieved (e.g., none found).
Internal Server Error - An unexpected issue occurred on the server.
Enter your bearer token (Firebase auth) in the format: Bearer
List of session document IDs to retrieve.
Sessions retrieved successfully.
Bad Request - session_ids missing or invalid.
Unauthorized - No token provided.
Forbidden - User is not an admin.
Internal Server Error - Something went wrong on the server.
Enter your bearer token (Firebase auth) in the format: Bearer
Session deleted successfully.
Bad Request - Invalid parameters or missing data.
Unauthorized - Token is invalid or expired.
Forbidden - User lacks necessary privileges.
Not Found - The specified session ID does not exist.
Internal Server Error - An unexpected issue occurred on the server.
Enter your bearer token (Firebase auth) in the format: Bearer
New title for the session.
Updated session timestamp in YYYY-MM-DD HH:MM:SS format.
Session updated successfully.
Bad Request - Invalid parameters or missing data.
Unauthorized - Missing or invalid access token.
Forbidden - The user does not have sufficient privileges to retrieve total metrics.
Not Found - The specified session ID does not exist.
Internal Server Error - An unexpected issue occurred on the server.
Enter your bearer token (Firebase auth) in the format: Bearer
Session ID after which to start pagination (only used if no filters are set).
Session ID before which to end pagination (only used if no filters are set).
Maximum number of sessions to fetch (default=10).
Activity type filter (e.g., 'Running', 'Weightlifting', 'Vertical Jump', or 'Mobility Assessment').
Filter sessions created on or after this date (dd/mm/yyyy).
Filter sessions created on or before this date (dd/mm/yyyy).
Filter by sessions whose title contains this substring (case-insensitive).
Filter by user ID stored in the session document.
ID of the user (admin / sub-admin) who uploaded the video.
Processing state of the session video.
Filtered sessions retrieved successfully.
Bad Request - Potentially invalid parameters (malformed date, etc.) or missing user token.
Unauthorized - Missing or invalid access token.
Forbidden - The user lacks admin privileges.
Not Found - No matching sessions found or resource unavailable.
Internal Server Error - An unexpected error occurred on the server.
Enter your bearer token (Firebase auth) in the format: Bearer
Indicates whether this session is for jump analysis.
Indicates whether this session is for weightlifting analysis.
If true, returns a signed URL that forces download of the video.
Analyzed video URL retrieved successfully.
Bad Request - Possibly invalid parameters.
Unauthorized - Token is invalid or missing.
Forbidden - User lacks privileges or plan.
Not Found - Session data or resource not found.
Internal Server Error - A server-side error occurred.
Enter your bearer token (Firebase auth) in the format: Bearer
Whether this session is jump-related.
Whether this session is weightlifting-related.
Analyzed video URL generated or updated successfully.
Bad Request - Possibly invalid session data or video already analyzed.
Unauthorized - The token is missing or invalid.
Forbidden - The user does not have a valid payment plan.
Not Found - Session not found or creation failed.
Internal Server Error - A server-side error occurred.
Last updated
Was this helpful?