API Spec

Production API

• Authentication
  • postAnonymousAuthHandler handles anonymous user authentication
  • postHandleLogin processes user login requests
  • postProviderHandler initiates third-party provider authentication
  • postHandleSignUp processes user signup requests
• Classes
  • getGetAllClasses retrieves all classes with optional pagination and filtering
  • postCreateClass creates a new class
  • putUpdateEnrollmentStatus updates a user's enrollment status in a class
  • getGetClassesByInstructor retrieves classes taught by a specific instructor
  • postRegisterClass registers a user to a class
  • postUnregisterClass unregisters a user from a class
  • getGetAClass retrieves a specific class by ID
  • putUpdateClass updates an existing class
  • delDeleteClass deletes a class by ID
  • putUpdateClassStudentsSettings updates settings for multiple students in a class
• Data Export
  • getExportAllData exports all user data in JSON format
• Storage
  • postHandle image upload
  • delHandle image deletion
• Logger
  • getGetAllErrorsHandler retrieves all logged errors
• Logs
  • getGetAllLogs retrieves all logs from the database
  • getGetLogsByClassID retrieves logs for a specific class
  • getHandleLogsForInstructor retrieves logs for a specific instructor
  • postLogSuggestionEvent logs a suggestion event
  • getGetUserSuggestionLogsByMode retrieves suggestion logs for a user based on GetUserSuggestionLogsByMode
  • getGetUserTypingLogs retrieves typing logs and statistics for a specific user
  • postLogUserTyping logs typing statistics for a user
  • postLogUserEvent logs a user event
  • getGetLogsByUserID retrieves logs for a specific user
• Status
  • getGetAIUsage retrieves AI usage statistics
• Suggestions
  • post/api/v1/suggestion/{mode}
  • getGetSuggestionByModeAndId retrieves a suggestion based on mode and ID
• Users
  • getGet all users
  • getGet classes by student ID
  • getGet a user by ID
  • delDelete a user by ID
  • patchUpdate a user by ID
  • putUpdate user settings

API docs by Redocly

CLOVER API (1.0)

Download OpenAPI specification:Download

REST API for CLOVER.

Authentication

AnonymousAuthHandler handles anonymous user authentication

Allows users to log in or sign up anonymously using a shared password and optional code

Request Body schema: application/json

Anonymous authentication request payload

classId	string
code	string
isConsent	boolean

Responses

https://api.clover.nickrucinski.com/api/v1/auth/anonymous

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "code": "string",
• "isConsent": true

}

Response samples

• 200
• 400
• 401
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

HandleLogin processes user login requests

Authenticates a user using email and password

Request Body schema: application/json

Login request payload

email	string
password	string

Responses

https://api.clover.nickrucinski.com/api/v1/auth/login

Request samples

• Payload

Content type

application/json

{

• "email": "string",
• "password": "string"

}

Response samples

• 200
• 400
• 401

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

ProviderHandler initiates third-party provider authentication

Redirects the user to the third-party provider's authentication page

path Parameters

provider required

string Third-party provider (e.g., google, github)

query Parameters

redirect_to

string URL to redirect to after authentication

Responses

https://api.clover.nickrucinski.com/api/v1/auth/provider/{provider}

Response samples

• 302
• 500

Content type

application/json

"string"

HandleSignUp processes user signup requests

Registers a new user using email, password, first name, and last name

Request Body schema: application/json

Signup request payload

email	string
firstName	string
isConsent	boolean
lastName	string
password	string

Responses

https://api.clover.nickrucinski.com/api/v1/auth/signup

Request samples

• Payload

Content type

application/json

{

• "email": "string",
• "firstName": "string",
• "isConsent": true,
• "lastName": "string",
• "password": "string"

}

Response samples

• 200
• 400
• 401
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Classes

GetAllClasses retrieves all classes with optional pagination and filtering

Fetches all classes, with options for pagination, searching, and filtering by user

query Parameters

includeStudents	boolean Whether to include enrolled students in the response
page	integer Page number for pagination (default is 1)
limit	integer Number of items per page for pagination (default is 50)
search	string Search term to filter classes by title or code
user_id	string Filter classes by a specific user ID (instructor or student)

Responses

https://api.clover.nickrucinski.com/api/v1/classes/

Response samples

• 200
• 500

Content type

application/json

{ }

CreateClass creates a new class

Creates a new class in the database with the provided details

Request Body schema: application/json

Class creation request

classCode	string
classDescription	string
classHexColor	string
classImageCover	string
classTitle	string
instructorId	string

Responses

https://api.clover.nickrucinski.com/api/v1/classes/

Request samples

• Payload

Content type

application/json

{

• "classCode": "string",
• "classDescription": "string",
• "classHexColor": "string",
• "classImageCover": "string",
• "classTitle": "string",
• "instructorId": "string"

}

Response samples

• 201
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

UpdateEnrollmentStatus updates a user's enrollment status in a class

Updates the enrollment status of a user in a specific class

Request Body schema: application/json

Enrollment status update request

classId required	string
status required	string
userId required	string

Responses

https://api.clover.nickrucinski.com/api/v1/classes/enrollment-status

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "status": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetClassesByInstructor retrieves classes taught by a specific instructor

Fetches all classes associated with the given instructor ID. Optionally includes enrolled students

path Parameters

instructor_id required

string Instructor ID

query Parameters

includeStudents

boolean Whether to include enrolled students in the response

Responses

https://api.clover.nickrucinski.com/api/v1/classes/instructor/{instructor_id}

Response samples

• 200
• 400
• 500

Content type

application/json

[

• {

  • "classCode": "string",
  • "classDescription": "string",
  • "classHexColor": "string",
  • "classImageCover": "string",
  • "classTitle": "string",
  • "createdAt": "string",
  • "enrollmentStatus": "WAITLISTED",
  • "id": "string",
  • "instructorId": "string",
  • "instructorName": "string",
  • "joinedAt": "string",
  • "studentCount": 0,
  • "students": [

    • {

      • "avatarUrl": "string",
      • "createdAt": "string",
      • "email": "string",
      • "enrollmentStatus": "WAITLISTED",
      • "firstName": "string",
      • "id": "string",
      • "isConsent": true,
      • "lastName": "string",
      • "pid": "string",
      • "role": "STUDENT",
      • "settings": {

        • "bugPercentage": 0,
        • "enableDashboard": true,
        • "enableQuiz": true,
        • "mode": "string",
        • "showNotifications": true,
        • "test_group": "string"

        },
      • "status": "string"

      }

    ]

  }

]

RegisterClass registers a user to a class

Registers a user to a class in the database

Request Body schema: application/json

Class registration request

classId required	string
userId required	string

Responses

https://api.clover.nickrucinski.com/api/v1/classes/register

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

UnregisterClass unregisters a user from a class

Unregisters a user from a specific class in the database

Request Body schema: application/json

Class unregistration request

classId required	string
userId required	string

Responses

https://api.clover.nickrucinski.com/api/v1/classes/unregister

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetAClass retrieves a specific class by ID

Fetches a class from the database based on the provided class ID. Optionally includes enrolled students and enrollment status for a specific user

path Parameters

class_id required

string ID of the class

query Parameters

includeStudents	boolean Whether to include enrolled students in the response
user_id	string User ID to get enrollment status for (optional)

Responses

https://api.clover.nickrucinski.com/api/v1/classes/{class_id}

Response samples

• 200
• 400
• 404
• 500

Content type

application/json

{

• "classCode": "string",
• "classDescription": "string",
• "classHexColor": "string",
• "classImageCover": "string",
• "classTitle": "string",
• "createdAt": "string",
• "enrollmentStatus": "WAITLISTED",
• "id": "string",
• "instructorId": "string",
• "instructorName": "string",
• "joinedAt": "string",
• "studentCount": 0,
• "students": [

  • {

    • "avatarUrl": "string",
    • "createdAt": "string",
    • "email": "string",
    • "enrollmentStatus": "WAITLISTED",
    • "firstName": "string",
    • "id": "string",
    • "isConsent": true,
    • "lastName": "string",
    • "pid": "string",
    • "role": "STUDENT",
    • "settings": {

      • "bugPercentage": 0,
      • "enableDashboard": true,
      • "enableQuiz": true,
      • "mode": "string",
      • "showNotifications": true,
      • "test_group": "string"

      },
    • "status": "string"

    }

  ]

}

UpdateClass updates an existing class

Updates the details of an existing class in the database

path Parameters

class_id required

string ID of the class to update

Request Body schema: application/json

Class update request

classCode	string
classDescription	string
classHexColor	string
classImageCover	string
classTitle	string
instructorId	string

Responses

https://api.clover.nickrucinski.com/api/v1/classes/{class_id}

Request samples

• Payload

Content type

application/json

{

• "classCode": "string",
• "classDescription": "string",
• "classHexColor": "string",
• "classImageCover": "string",
• "classTitle": "string",
• "instructorId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

DeleteClass deletes a class by ID

Deletes a class from the database based on the provided class ID

path Parameters

class_id required

string ID of the class to delete

Responses

https://api.clover.nickrucinski.com/api/v1/classes/{class_id}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

UpdateClassStudentsSettings updates settings for multiple students in a class

Updates the user settings for multiple students enrolled in a specific class

path Parameters

class_id required

string ID of the class

Request Body schema: application/json

Settings update request

required	object (models.UserSettings)
studentIds required	Array of strings

Responses

https://api.clover.nickrucinski.com/api/v1/classes/{class_id}/students/settings

Request samples

• Payload

Content type

application/json

{

• "settings": {

  • "bugPercentage": 0,
  • "enableDashboard": true,
  • "enableQuiz": true,
  • "mode": "string",
  • "showNotifications": true,
  • "test_group": "string"

  },
• "studentIds": [

  • "string"

  ]

}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

Data Export

ExportAllData exports all user data in JSON format

Exports all user data from the database in JSON format for download

Responses

https://api.clover.nickrucinski.com/api/v1/data/

Response samples

• 200
• 500

Content type

application/json

"string"

Storage

Handle image upload

Endpoint to handle image uploads to Supabase Storage

Request Body schema: multipart/form-data

image required

string <binary> Image file to upload

Responses

https://api.clover.nickrucinski.com/api/v1/image/upload

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "error": "string",
• "image_path": "string",
• "image_url": "string",
• "success": true

}

Handle image deletion

Endpoint to handle image deletions from Supabase Storage

path Parameters

image_path required

string Path of the image to delete

Responses

https://api.clover.nickrucinski.com/api/v1/image/{image_path}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

Logger

GetAllErrorsHandler retrieves all logged errors

Fetches all error logs from the database

Responses

https://api.clover.nickrucinski.com/api/v1/logger/

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "client_ip": "string",
  • "error_message": "string",
  • "method": "string",
  • "request_path": "string",
  • "route": "string",
  • "status_code": 0,
  • "user_agent": "string"

  }

]

Logs

GetAllLogs retrieves all logs from the database

Fetches all logs from the database

Responses

https://api.clover.nickrucinski.com/api/v1/logs/

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

GetLogsByClassID retrieves logs for a specific class

Fetches logs from the database for a specific class ID

path Parameters

class_id required

string ID of the class

Responses

https://api.clover.nickrucinski.com/api/v1/logs/class/{class_id}

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

HandleLogsForInstructor retrieves logs for a specific instructor

Fetches logs from the database for a specific instructor ID

path Parameters

instructor_id required

string ID of the instructor

Responses

https://api.clover.nickrucinski.com/api/v1/logs/instructor/{instructor_id}

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

LogSuggestionEvent logs a suggestion event

Logs a suggestion event to the database based on the mode

path Parameters

mode required

string Mode of the suggestion (CODE_BLOCK, LINE_BY_LINE, CODE_SELECTION)

Request Body schema: application/json

Log Suggestion Event Request

any

Responses

https://api.clover.nickrucinski.com/api/v1/logs/suggestion/{mode}

Request samples

• Payload

Content type

application/json

null

Response samples

• 201
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetUserSuggestionLogsByMode retrieves suggestion logs for a user based on GetUserSuggestionLogsByMode

Fetches suggestion logs from the database for a specific user and mode

path Parameters

user_id required	string ID of the user
mode required	string Mode of the suggestion logs to retrieve (CODE_BLOCK, LINE_BY_LINE, CODE_SELECTION)

Responses

https://api.clover.nickrucinski.com/api/v1/logs/suggestion/{user_id}/{mode}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

GetUserTypingLogs retrieves typing logs and statistics for a specific user

Fetches typing logs and statistics from the database for a specific user ID and mode

path Parameters

user_id required

string ID of the user

query Parameters

mode required	string Mode of typing logs to retrieve (block, line, or selection)
interval_type	string Type of interval for statistics (days, weeks, months, hours, minutes). Default is days.
interval_count	integer Number of intervals to retrieve. Default is 30.

Responses

https://api.clover.nickrucinski.com/api/v1/logs/typing/{user_id}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "logs": [

  • {

    • "acceptedNumber": 0,
    • "createdAt": "string",
    • "id": "string",
    • "suggestionId": "string",
    • "suggestionLineId": "string",
    • "suggestionSelectionItemId": "string",
    • "typedNumber": 0,
    • "userId": "string"

    }

  ],
• "totalAccepted": 0,
• "totalTyped": 0,
• "typingRate": 0

}

LogUserTyping logs typing statistics for a user

Logs typing statistics to the database for a specific user

path Parameters

user_id required

string ID of the user

Request Body schema: application/json

Typing Statistics Request

accepted_number	integer
suggestion_id	string
suggestion_line_id	string
suggestion_selection_item_id	string
typed_number	integer

Responses

https://api.clover.nickrucinski.com/api/v1/logs/typing/{user_id}

Request samples

• Payload

Content type

application/json

{

• "accepted_number": 0,
• "suggestion_id": "string",
• "suggestion_line_id": "string",
• "suggestion_selection_item_id": "string",
• "typed_number": 0

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

LogUserEvent logs a user event

Logs a user event to the database

Request Body schema: application/json

Log User Event Request

error_message	string
event required	string
user_id	string

Responses

https://api.clover.nickrucinski.com/api/v1/logs/user

Request samples

• Payload

Content type

application/json

{

• "error_message": "string",
• "event": "string",
• "user_id": "string"

}

Response samples

• 201
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetLogsByUserID retrieves logs for a specific user

Fetches logs from the database for a specific user ID

path Parameters

user_id required

string ID of the user

Responses

https://api.clover.nickrucinski.com/api/v1/logs/{user_id}

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

Status

GetAIUsage retrieves AI usage statistics

Fetches AI usage statistics from the database

Responses

https://api.clover.nickrucinski.com/api/v1/status/ai

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "created_at": "string",
  • "id": 0,
  • "input_tokens": 0,
  • "latency_seconds": 0,
  • "model": "string",
  • "output_tokens": 0,
  • "provider": "string",
  • "total_tokens": 0

  }

]

Suggestions

/api/v1/suggestion/{mode}

path Parameters

mode required

string Suggestion mode: code_block, line_by_line, code_selection

Request Body schema: application/json

Suggestion request payload

bugPercentage	integer
classId	string
fileName	string
language	string
prompt	string
rawText	string
userId	string

Responses

https://api.clover.nickrucinski.com/api/v1/suggestion/{mode}

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "classId": "string",
• "fileName": "string",
• "language": "string",
• "prompt": "string",
• "rawText": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

GetSuggestionByModeAndId retrieves a suggestion based on mode and ID

Fetches a suggestion from the database based on the provided mode and suggestion ID

path Parameters

mode required	string Mode of the suggestion (CODE_BLOCK, LINE_BY_LINE, CODE_SELECTION)
suggestion_id required	string ID of the suggestion

Responses

https://api.clover.nickrucinski.com/api/v1/suggestions/{mode}/{suggestion_id}

Response samples

• 200
• 400
• 404
• 500

Content type

application/json

null

Users

Get all users

Retrieves all user's details.

Responses

https://api.clover.nickrucinski.com/api/v1/users/

Get classes by student ID

Retrieves all classes a specific student is enrolled in.

path Parameters

student_id required

string Student ID

Responses

https://api.clover.nickrucinski.com/api/v1/users/{student_id}/classes

Response samples

• 200
• 400
• 500

Content type

application/json

[

• {

  • "classCode": "string",
  • "classDescription": "string",
  • "classHexColor": "string",
  • "classImageCover": "string",
  • "classTitle": "string",
  • "createdAt": "string",
  • "enrollmentStatus": "WAITLISTED",
  • "id": "string",
  • "instructorId": "string",
  • "instructorName": "string",
  • "joinedAt": "string",
  • "studentCount": 0,
  • "students": [

    • {

      • "avatarUrl": "string",
      • "createdAt": "string",
      • "email": "string",
      • "enrollmentStatus": "WAITLISTED",
      • "firstName": "string",
      • "id": "string",
      • "isConsent": true,
      • "lastName": "string",
      • "pid": "string",
      • "role": "STUDENT",
      • "settings": {

        • "bugPercentage": 0,
        • "enableDashboard": true,
        • "enableQuiz": true,
        • "mode": "string",
        • "showNotifications": true,
        • "test_group": "string"

        },
      • "status": "string"

      }

    ]

  }

]

Get a user by ID

Retrieves user details based on the user ID.

path Parameters

user_id required

string User ID

Responses

https://api.clover.nickrucinski.com/api/v1/users/{user_id}

Delete a user by ID

Deletes a user and their associated data based on the user ID.

path Parameters

user_id required

string User ID

Responses

https://api.clover.nickrucinski.com/api/v1/users/{user_id}

Update a user by ID

Updates a user's details based on the user ID. Fields are optional.

path Parameters

user_id required

string User ID

Responses

https://api.clover.nickrucinski.com/api/v1/users/{user_id}

Response samples

• 200
• 400
• 404
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Update user settings

Updates the settings for a specific user based on their ID.

path Parameters

user_id required

string User ID

Request Body schema: application/json

User Settings Payload

bugPercentage	integer
enableDashboard	boolean
enableQuiz	boolean
mode	string
showNotifications	boolean
test_group	string

Responses

https://api.clover.nickrucinski.com/api/v1/users/{user_id}/settings

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "enableDashboard": true,
• "enableQuiz": true,
• "mode": "string",
• "showNotifications": true,
• "test_group": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Development API

• Authentication
  • postAnonymousAuthHandler handles anonymous user authentication
  • postHandleLogin processes user login requests
  • getProviderHandler initiates third-party provider authentication
  • postHandleSignUp processes user signup requests
• Classes
  • getGetAllClasses retrieves all classes with optional pagination and filtering
  • postCreateClass creates a new class
  • putUpdateEnrollmentStatus updates a user's enrollment status in a class
  • getGetClassesByInstructor retrieves classes taught by a specific instructor
  • postRegisterClass registers a user to a class
  • delUnregisterClass unregisters a user from a class
  • getGetAClass retrieves a specific class by ID
  • putUpdateClass updates an existing class
  • delDeleteClass deletes a class by ID
  • putUpdateClassStudentsSettings updates settings for multiple students in a class
• Users
  • getGet classes by student ID
  • getGet all users
  • getGet a user by ID
  • putUpdate a user by ID
  • delDelete a user by ID
  • putUpdate user settings
• Data Export
  • getExportAllData exports all user data in JSON format
• Storage
  • postHandle image upload
  • delHandle image deletion
• Logger
  • getGetAllErrorsHandler retrieves all logged errors
• Logs
  • getGetAllLogs retrieves all logs from the database
  • getGetLogsByClassID retrieves logs for a specific class
  • getHandleLogsForInstructor retrieves logs for a specific instructor
  • postLogSuggestionEvent logs a suggestion event
  • getGetUserSuggestionLogsByMode retrieves suggestion logs for a user based on GetUserSuggestionLogsByMode
  • getGetUserTypingLogs retrieves typing logs and statistics for a specific user
  • postLogUserTyping logs typing statistics for a user
  • postLogUserEvent logs a user event
  • getGetLogsByUserID retrieves logs for a specific user
• Status
  • getGetAIUsage retrieves AI usage statistics
• Suggestions
  • postHandleSuggestion processes code suggestions based on the specified mode (block, line-by-line, selection).
  • postHandleSuggestionTest processes code suggestions based on the specified mode (block, line-by-line, selection).
  • getGetSuggestionByModeAndId retrieves a suggestion based on mode and ID
  • putHandleSuggestion processes line-by-line code suggestions directly without mode parameter
  • postHandleSuggestion processes line-by-line code suggestions directly without mode parameter
• V2 Logs
  • putLog an event idempotently
  • postLog an event idempotently
  • putLog a ProgSnap event idempotently
  • postLog a ProgSnap event idempotently
  • putLog terminal contents idempotently
  • postLog terminal contents idempotently
  • putLog a suggestion event idempotently
  • postLog a suggestion event idempotently

API docs by Redocly

CLOVER API (1.0)

Download OpenAPI specification:Download

REST API for CLOVER.

Authentication

AnonymousAuthHandler handles anonymous user authentication

Requires code as the anonymous username and auth_mode signin or signup. Signup additionally requires consent information. Uses a server-configured shared password.

path Parameters

auth_mode required

string Enum: "signin" "signup" Anonymous authentication action

Request Body schema: application/json

Anonymous authentication request payload

classId	string
code	string
isConsent	boolean

Responses

https://dev.api.clover.nickrucinski.com/api/v1/auth/anonymous/{auth_mode}

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "code": "string",
• "isConsent": true

}

Response samples

• 200
• 400
• 401
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

HandleLogin processes user login requests

Authenticates a user using email and password

Request Body schema: application/json

Login request payload

email	string
password	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/auth/login

Request samples

• Payload

Content type

application/json

{

• "email": "string",
• "password": "string"

}

Response samples

• 200
• 400
• 401

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

ProviderHandler initiates third-party provider authentication

Redirects the user to the third-party provider's authentication page

path Parameters

provider required

string Third-party provider (e.g., google, github)

query Parameters

redirect_to

string URL to redirect to after authentication

Responses

https://dev.api.clover.nickrucinski.com/api/v1/auth/provider/{provider}

Response samples

• 302
• 500

Content type

application/json

"string"

HandleSignUp processes user signup requests

Registers a new user using email, password, first name, and last name

Request Body schema: application/json

Signup request payload

email	string
firstName	string
isConsent	boolean
lastName	string
password	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/auth/signup

Request samples

• Payload

Content type

application/json

{

• "email": "string",
• "firstName": "string",
• "isConsent": true,
• "lastName": "string",
• "password": "string"

}

Response samples

• 200
• 400
• 401
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Classes

GetAllClasses retrieves all classes with optional pagination and filtering

Fetches all classes, with options for pagination, searching, and filtering by user

query Parameters

includeStudents	boolean Whether to include enrolled students in the response
page	integer Page number for pagination (default is 1)
limit	integer Number of items per page for pagination (default is 50)
search	string Search term to filter classes by title or code
user_id	string Filter classes by a specific user ID (instructor or student)

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/

Response samples

• 200
• 500

Content type

application/json

{ }

CreateClass creates a new class

Creates a new class in the database with the provided details

Request Body schema: application/json

Class creation request

classCode	string
classDescription	string
classHexColor	string
classImageCover	string
classTitle	string
instructorId	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/

Request samples

• Payload

Content type

application/json

{

• "classCode": "string",
• "classDescription": "string",
• "classHexColor": "string",
• "classImageCover": "string",
• "classTitle": "string",
• "instructorId": "string"

}

Response samples

• 201
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

UpdateEnrollmentStatus updates a user's enrollment status in a class

Updates the enrollment status of a user in a specific class

Request Body schema: application/json

Enrollment status update request

classId required	string
status required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/enrollment-status

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "status": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetClassesByInstructor retrieves classes taught by a specific instructor

Fetches all classes associated with the given instructor ID. Optionally includes enrolled students

path Parameters

instructor_id required

string Instructor ID

query Parameters

includeStudents

boolean Whether to include enrolled students in the response

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/instructor/{instructor_id}

Response samples

• 200
• 400
• 500

Content type

application/json

[

• {

  • "classCode": "string",
  • "classDescription": "string",
  • "classHexColor": "string",
  • "classImageCover": "string",
  • "classTitle": "string",
  • "createdAt": "string",
  • "enrollmentStatus": "WAITLISTED",
  • "id": "string",
  • "instructorId": "string",
  • "instructorName": "string",
  • "joinedAt": "string",
  • "studentCount": 0,
  • "students": [

    • {

      • "avatarUrl": "string",
      • "createdAt": "string",
      • "email": "string",
      • "enrollmentStatus": "WAITLISTED",
      • "firstName": "string",
      • "id": "string",
      • "isConsent": true,
      • "lastName": "string",
      • "pid": "string",
      • "role": "STUDENT",
      • "settings": {

        • "bugPercentage": 0,
        • "enableDashboard": true,
        • "enableQuiz": true,
        • "mode": "string",
        • "showNotifications": true,
        • "test_group": "string"

        },
      • "status": "string"

      }

    ]

  }

]

RegisterClass registers a user to a class

Registers a user to a class in the database

Request Body schema: application/json

Class registration request

classId required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/register

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

UnregisterClass unregisters a user from a class

Unregisters a user from a specific class in the database

Request Body schema: application/json

Class unregistration request

classId required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/unregister

Request samples

• Payload

Content type

application/json

{

• "classId": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetAClass retrieves a specific class by ID

Fetches a class from the database based on the provided class ID. Optionally includes enrolled students and enrollment status for a specific user

path Parameters

class_id required

string ID of the class

query Parameters

includeStudents	boolean Whether to include enrolled students in the response
user_id	string User ID to get enrollment status for (optional)

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/{class_id}

Response samples

• 200
• 400
• 404
• 500

Content type

application/json

{

• "classCode": "string",
• "classDescription": "string",
• "classHexColor": "string",
• "classImageCover": "string",
• "classTitle": "string",
• "createdAt": "string",
• "enrollmentStatus": "WAITLISTED",
• "id": "string",
• "instructorId": "string",
• "instructorName": "string",
• "joinedAt": "string",
• "studentCount": 0,
• "students": [

  • {

    • "avatarUrl": "string",
    • "createdAt": "string",
    • "email": "string",
    • "enrollmentStatus": "WAITLISTED",
    • "firstName": "string",
    • "id": "string",
    • "isConsent": true,
    • "lastName": "string",
    • "pid": "string",
    • "role": "STUDENT",
    • "settings": {

      • "bugPercentage": 0,
      • "enableDashboard": true,
      • "enableQuiz": true,
      • "mode": "string",
      • "showNotifications": true,
      • "test_group": "string"

      },
    • "status": "string"

    }

  ]

}

UpdateClass updates an existing class

Updates the details of an existing class in the database

path Parameters

class_id required

string ID of the class to update

Request Body schema: application/json

Class update request

classCode	string
classDescription	string
classHexColor	string
classImageCover	string
classTitle	string
instructorId	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/{class_id}

Request samples

• Payload

Content type

application/json

{

• "classCode": "string",
• "classDescription": "string",
• "classHexColor": "string",
• "classImageCover": "string",
• "classTitle": "string",
• "instructorId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

DeleteClass deletes a class by ID

Deletes a class from the database based on the provided class ID

path Parameters

class_id required

string ID of the class to delete

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/{class_id}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

UpdateClassStudentsSettings updates settings for multiple students in a class

Updates the user settings for multiple students enrolled in a specific class

path Parameters

class_id required

string ID of the class

Request Body schema: application/json

Settings update request

required	object (models.UserSettings)
studentIds required	Array of strings

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/{class_id}/students/settings

Request samples

• Payload

Content type

application/json

{

• "settings": {

  • "bugPercentage": 0,
  • "enableDashboard": true,
  • "enableQuiz": true,
  • "mode": "string",
  • "showNotifications": true,
  • "test_group": "string"

  },
• "studentIds": [

  • "string"

  ]

}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

Users

Get classes by student ID

Retrieves all classes a specific student is enrolled in.

path Parameters

student_id required

string Student ID

Responses

https://dev.api.clover.nickrucinski.com/api/v1/classes/students/{student_id}

Response samples

• 200
• 400
• 500

Content type

application/json

[

• {

  • "classCode": "string",
  • "classDescription": "string",
  • "classHexColor": "string",
  • "classImageCover": "string",
  • "classTitle": "string",
  • "createdAt": "string",
  • "enrollmentStatus": "WAITLISTED",
  • "id": "string",
  • "instructorId": "string",
  • "instructorName": "string",
  • "joinedAt": "string",
  • "studentCount": 0,
  • "students": [

    • {

      • "avatarUrl": "string",
      • "createdAt": "string",
      • "email": "string",
      • "enrollmentStatus": "WAITLISTED",
      • "firstName": "string",
      • "id": "string",
      • "isConsent": true,
      • "lastName": "string",
      • "pid": "string",
      • "role": "STUDENT",
      • "settings": {

        • "bugPercentage": 0,
        • "enableDashboard": true,
        • "enableQuiz": true,
        • "mode": "string",
        • "showNotifications": true,
        • "test_group": "string"

        },
      • "status": "string"

      }

    ]

  }

]

Get all users

Retrieves all user's details.

Responses

https://dev.api.clover.nickrucinski.com/api/v1/users/

Get a user by ID

Retrieves user details based on the user ID.

path Parameters

user_id required

string User ID

Responses

https://dev.api.clover.nickrucinski.com/api/v1/users/{user_id}

Update a user by ID

Updates a user's details based on the user ID. Fields are optional.

path Parameters

user_id required

string User ID

Responses

https://dev.api.clover.nickrucinski.com/api/v1/users/{user_id}

Response samples

• 200
• 400
• 404
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Delete a user by ID

Deletes a user and their associated data based on the user ID.

path Parameters

user_id required

string User ID

Responses

https://dev.api.clover.nickrucinski.com/api/v1/users/{user_id}

Update user settings

Updates the settings for a specific user based on their ID.

path Parameters

user_id required

string User ID

Request Body schema: application/json

User Settings Payload

bugPercentage	integer
enableDashboard	boolean
enableQuiz	boolean
mode	string
showNotifications	boolean
test_group	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/users/{user_id}/settings

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "enableDashboard": true,
• "enableQuiz": true,
• "mode": "string",
• "showNotifications": true,
• "test_group": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Data Export

ExportAllData exports all user data in JSON format

Exports all user data from the database in JSON format for download

Responses

https://dev.api.clover.nickrucinski.com/api/v1/data/

Response samples

• 200
• 500

Content type

application/json

"string"

Storage

Handle image upload

Endpoint to handle image uploads to Supabase Storage

Request Body schema: multipart/form-data

image required

string <binary> Image file to upload

Responses

https://dev.api.clover.nickrucinski.com/api/v1/images/upload

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "error": "string",
• "image_path": "string",
• "image_url": "string",
• "success": true

}

Handle image deletion

Endpoint to handle image deletions from Supabase Storage

path Parameters

image_path required

string Path of the image to delete

Responses

https://dev.api.clover.nickrucinski.com/api/v1/images/{image_path}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

Logger

GetAllErrorsHandler retrieves all logged errors

Fetches all error logs from the database

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logger/

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "client_ip": "string",
  • "error_message": "string",
  • "method": "string",
  • "request_path": "string",
  • "route": "string",
  • "status_code": 0,
  • "user_agent": "string"

  }

]

Logs

GetAllLogs retrieves all logs from the database

Fetches all logs from the database

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

GetLogsByClassID retrieves logs for a specific class

Fetches logs from the database for a specific class ID

path Parameters

class_id required

string ID of the class

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/class/{class_id}

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

HandleLogsForInstructor retrieves logs for a specific instructor

Fetches logs from the database for a specific instructor ID

path Parameters

instructor_id required

string ID of the instructor

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/instructor/{instructor_id}

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

LogSuggestionEvent logs a suggestion event

Logs a suggestion event to the database based on the mode

path Parameters

mode required

string Enum: "code-block" "line-by-line" "code-selection" Suggestion mode

Request Body schema: application/json

Log Suggestion Event Request

any

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/suggestion/{mode}

Request samples

• Payload

Content type

application/json

null

Response samples

• 201
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetUserSuggestionLogsByMode retrieves suggestion logs for a user based on GetUserSuggestionLogsByMode

Fetches suggestion logs from the database for a specific user and mode

path Parameters

user_id required	string ID of the user
mode required	string Enum: "code-block" "line-by-line" "code-selection" Suggestion log mode

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/suggestion/{user_id}/{mode}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

GetUserTypingLogs retrieves typing logs and statistics for a specific user

Fetches typing logs and statistics from the database for a specific user ID and mode

path Parameters

user_id required

string ID of the user

query Parameters

mode required	string Mode of typing logs to retrieve (block, line, or selection)
interval_type	string Type of interval for statistics (days, weeks, months, hours, minutes). Default is days.
interval_count	integer Number of intervals to retrieve. Default is 30.

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/typing/{user_id}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "logs": [

  • {

    • "acceptedNumber": 0,
    • "createdAt": "string",
    • "id": "string",
    • "suggestionId": "string",
    • "suggestionLineId": "string",
    • "suggestionSelectionItemId": "string",
    • "typedNumber": 0,
    • "userId": "string"

    }

  ],
• "totalAccepted": 0,
• "totalTyped": 0,
• "typingRate": 0

}

LogUserTyping logs typing statistics for a user

Logs typing statistics to the database for a specific user

path Parameters

user_id required

string ID of the user

Request Body schema: application/json

Typing Statistics Request

accepted_number	integer
suggestion_id	string
suggestion_line_id	string
suggestion_selection_item_id	string
typed_number	integer

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/typing/{user_id}

Request samples

• Payload

Content type

application/json

{

• "accepted_number": 0,
• "suggestion_id": "string",
• "suggestion_line_id": "string",
• "suggestion_selection_item_id": "string",
• "typed_number": 0

}

Response samples

• 200
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

LogUserEvent logs a user event

Logs a user event to the database

Request Body schema: application/json

Log User Event Request

error_message	string
event required	string
user_id	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/user

Request samples

• Payload

Content type

application/json

{

• "error_message": "string",
• "event": "string",
• "user_id": "string"

}

Response samples

• 201
• 400
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

GetLogsByUserID retrieves logs for a specific user

Fetches logs from the database for a specific user ID

path Parameters

user_id required

string ID of the user

Responses

https://dev.api.clover.nickrucinski.com/api/v1/logs/{user_id}

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "class_id": "string",
  • "duration": 0,
  • "event": "SUGGESTION_ACCEPT",
  • "explanation": "string",
  • "has_bug": true,
  • "language": "string",
  • "log_created_at": "string",
  • "log_id": "string",
  • "model": "string",
  • "prompt": "string",
  • "suggestion_array": [

    • "string"

    ],
  • "suggestion_created_at": "string",
  • "suggestion_id": "string",
  • "user_id": "string",
  • "vendor": "string"

  }

]

Status

GetAIUsage retrieves AI usage statistics

Fetches AI usage statistics from the database

Responses

https://dev.api.clover.nickrucinski.com/api/v1/status/ai

Response samples

• 200
• 500

Content type

application/json

[

• {

  • "created_at": "string",
  • "id": 0,
  • "input_tokens": 0,
  • "latency_seconds": 0,
  • "model": "string",
  • "output_tokens": 0,
  • "provider": "string",
  • "total_tokens": 0

  }

]

Suggestions

HandleSuggestion processes code suggestions based on the specified mode (block, line-by-line, selection).

path Parameters

mode required

string Enum: "code-block" "line-by-line" "code-selection" Suggestion mode

Request Body schema: application/json

Suggestion request payload

bugPercentage	integer
classId	string
fileName	string
language	string
prompt	string
rawText	string
userId	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/suggestion/{mode}

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "classId": "string",
• "fileName": "string",
• "language": "string",
• "prompt": "string",
• "rawText": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

HandleSuggestionTest processes code suggestions based on the specified mode (block, line-by-line, selection).

path Parameters

mode required

string Enum: "code-block" "line-by-line" "code-selection" Suggestion mode

Request Body schema: application/json

Suggestion request payload

bugPercentage	integer
fileName	string
language	string
prompt	string
rawText	string
version	string

Responses

https://dev.api.clover.nickrucinski.com/api/v1/suggestion/{mode}/test

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "fileName": "string",
• "language": "string",
• "prompt": "string",
• "rawText": "string",
• "version": "string"

}

Response samples

• 200
• 400
• 500

Content type

application/json

{ }

GetSuggestionByModeAndId retrieves a suggestion based on mode and ID

Fetches a suggestion from the database based on the provided mode and suggestion ID

path Parameters

mode required	string Enum: "code-block" "line-by-line" "code-selection" Suggestion mode
suggestion_id required	string ID of the suggestion

Responses

https://dev.api.clover.nickrucinski.com/api/v1/suggestion/{mode}/{suggestion_id}

Response samples

• 200
• 400
• 404
• 500

Content type

application/json

null

HandleSuggestion processes line-by-line code suggestions directly without mode parameter

Requires a nonempty client-generated eventId scoped to userId and this endpoint. Reuse the same eventId and decoded payload on retries to receive the original suggestions, suggestionLineId, and bugPercentage without another AI call or duplicate records. Concurrent retries wait for the first transaction. Failed attempts roll back and may invoke AI again on retry. Reusing a committed key with a different payload returns 409. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Suggestion request payload

bugPercentage	integer
classId	string
contextId	string
eventId required	string
fileName	string
language	string
prompt	string
snapshot	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/suggestion

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "classId": "string",
• "contextId": "string",
• "eventId": "string",
• "fileName": "string",
• "language": "string",
• "prompt": "string",
• "snapshot": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "bugPercentage": 0,
• "message": "string",
• "suggestionLineId": "string",
• "suggestions": [

  • {

    • "correctLine": "string",
    • "incorrectLine": "string",
    • "shownBug": true

    }

  ]

}

HandleSuggestion processes line-by-line code suggestions directly without mode parameter Deprecated

Requires a nonempty client-generated eventId scoped to userId and this endpoint. Reuse the same eventId and decoded payload on retries to receive the original suggestions, suggestionLineId, and bugPercentage without another AI call or duplicate records. Concurrent retries wait for the first transaction. Failed attempts roll back and may invoke AI again on retry. Reusing a committed key with a different payload returns 409. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Suggestion request payload

bugPercentage	integer
classId	string
contextId	string
eventId required	string
fileName	string
language	string
prompt	string
snapshot	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/suggestion

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "classId": "string",
• "contextId": "string",
• "eventId": "string",
• "fileName": "string",
• "language": "string",
• "prompt": "string",
• "snapshot": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "bugPercentage": 0,
• "message": "string",
• "suggestionLineId": "string",
• "suggestions": [

  • {

    • "correctLine": "string",
    • "incorrectLine": "string",
    • "shownBug": true

    }

  ]

}

V2 Logs

Log an event idempotently

Requires a nonempty client-generated eventId, scoped to userId and this endpoint. Retry with the same payload, including clientTimestamp (RFC3339), to receive the original 200 response without duplicate logs. Concurrent retries are deduplicated; failed transactions roll back and can be retried. Reusing the key with a different decoded payload returns 409. The client eventId does not replace server-generated row IDs. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Event with a stable client eventId

clientTimestamp required	string
event required	string
eventId required	string
lineSuggestionId	string
snapshot	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/event

Request samples

• Payload

Content type

application/json

{

• "clientTimestamp": "string",
• "event": "string",
• "eventId": "string",
• "lineSuggestionId": "string",
• "snapshot": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Log an event idempotently Deprecated

Requires a nonempty client-generated eventId, scoped to userId and this endpoint. Retry with the same payload, including clientTimestamp (RFC3339), to receive the original 200 response without duplicate logs. Concurrent retries are deduplicated; failed transactions roll back and can be retried. Reusing the key with a different decoded payload returns 409. The client eventId does not replace server-generated row IDs. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Event with a stable client eventId

clientTimestamp required	string
event required	string
eventId required	string
lineSuggestionId	string
snapshot	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/event

Request samples

• Payload

Content type

application/json

{

• "clientTimestamp": "string",
• "event": "string",
• "eventId": "string",
• "lineSuggestionId": "string",
• "snapshot": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Log a ProgSnap event idempotently

Requires UUIDv4 eventId and sessionId and integer sequence from 1 through 9007199254740991. Session positions are unique per user across ProgSnap, suggestion-event, and run logs; gaps and out-of-order arrival are allowed. After commit, acknowledges eventId, sessionId and sequence alongside server-generated event_id. Identical replays return the same acknowledgement without duplicate writes. Changed payloads or occupied session positions return 409. Internal logs keep server-generated IDs; no automatic retries. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

ProgSnap event with a stable client eventId

changeMade	string
clientTimestamp required	string
codeSnippet	string Event fields (optional)
codeUsed	string
contextId	string
editType	string Edit fields (optional - for edit events)
eventId required	string
eventType required	string Event fields (required)
fileName	string
isAttentionCheck	boolean
keyPress	string
language	string
sequence required	integer [ 1 .. 9007199254740991 ]
sessionId required	string
suggestionText	string Suggestion fields (optional - for suggestion events)
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/progsnap

Request samples

• Payload

Content type

application/json

{

• "changeMade": "string",
• "clientTimestamp": "string",
• "codeSnippet": "string",
• "codeUsed": "string",
• "contextId": "string",
• "editType": "string",
• "eventId": "string",
• "eventType": "string",
• "fileName": "string",
• "isAttentionCheck": true,
• "keyPress": "string",
• "language": "string",
• "sequence": 1,
• "sessionId": "string",
• "suggestionText": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "eventId": "string",
• "event_id": "string",
• "message": "string",
• "sequence": 0,
• "sessionId": "string"

}

Log a ProgSnap event idempotently Deprecated

Requires UUIDv4 eventId and sessionId and integer sequence from 1 through 9007199254740991. Session positions are unique per user across ProgSnap, suggestion-event, and run logs; gaps and out-of-order arrival are allowed. After commit, acknowledges eventId, sessionId and sequence alongside server-generated event_id. Identical replays return the same acknowledgement without duplicate writes. Changed payloads or occupied session positions return 409. Internal logs keep server-generated IDs; no automatic retries. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

ProgSnap event with a stable client eventId

changeMade	string
clientTimestamp required	string
codeSnippet	string Event fields (optional)
codeUsed	string
contextId	string
editType	string Edit fields (optional - for edit events)
eventId required	string
eventType required	string Event fields (required)
fileName	string
isAttentionCheck	boolean
keyPress	string
language	string
sequence required	integer [ 1 .. 9007199254740991 ]
sessionId required	string
suggestionText	string Suggestion fields (optional - for suggestion events)
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/progsnap

Request samples

• Payload

Content type

application/json

{

• "changeMade": "string",
• "clientTimestamp": "string",
• "codeSnippet": "string",
• "codeUsed": "string",
• "contextId": "string",
• "editType": "string",
• "eventId": "string",
• "eventType": "string",
• "fileName": "string",
• "isAttentionCheck": true,
• "keyPress": "string",
• "language": "string",
• "sequence": 1,
• "sessionId": "string",
• "suggestionText": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "eventId": "string",
• "event_id": "string",
• "message": "string",
• "sequence": 0,
• "sessionId": "string"

}

Log terminal contents idempotently

Requires UUIDv4 eventId and sessionId and integer sequence from 1 through 9007199254740991. Session positions are unique per user across ProgSnap, suggestion-event, and run logs; gaps and out-of-order arrival are allowed. Retry the same payload for the original 200 response and terminalLogId. Changed payloads or occupied session positions return 409. All writes and identity metadata commit atomically. clientTimestamp is run start (RFC3339); end time is start plus duration in milliseconds (0 through 9223372036854, default 0). exitCode is persisted, defaulting to 0. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Run event with a required stable client eventId

clientTimestamp required	string
duration	integer [ 0 .. 9223372036854 ]
eventId required	string
exitCode	integer
fileName required	string
language	string
sequence required	integer [ 1 .. 9007199254740991 ]
sessionId required	string
snapshot	string
terminalContents required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/run

Request samples

• Payload

Content type

application/json

{

• "clientTimestamp": "string",
• "duration": 9223372036854,
• "eventId": "string",
• "exitCode": 0,
• "fileName": "string",
• "language": "string",
• "sequence": 1,
• "sessionId": "string",
• "snapshot": "string",
• "terminalContents": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Log terminal contents idempotently Deprecated

Requires UUIDv4 eventId and sessionId and integer sequence from 1 through 9007199254740991. Session positions are unique per user across ProgSnap, suggestion-event, and run logs; gaps and out-of-order arrival are allowed. Retry the same payload for the original 200 response and terminalLogId. Changed payloads or occupied session positions return 409. All writes and identity metadata commit atomically. clientTimestamp is run start (RFC3339); end time is start plus duration in milliseconds (0 through 9223372036854, default 0). exitCode is persisted, defaulting to 0. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Run event with a required stable client eventId

clientTimestamp required	string
duration	integer [ 0 .. 9223372036854 ]
eventId required	string
exitCode	integer
fileName required	string
language	string
sequence required	integer [ 1 .. 9007199254740991 ]
sessionId required	string
snapshot	string
terminalContents required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/run

Request samples

• Payload

Content type

application/json

{

• "clientTimestamp": "string",
• "duration": 9223372036854,
• "eventId": "string",
• "exitCode": 0,
• "fileName": "string",
• "language": "string",
• "sequence": 1,
• "sessionId": "string",
• "snapshot": "string",
• "terminalContents": "string",
• "userId": "string"

}

Response samples

• 200
• 400
• 409
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Log a suggestion event idempotently

Requires UUIDv4 eventId and sessionId and integer sequence from 1 through 9007199254740991. Session positions are unique per user across ProgSnap, suggestion-event, and run logs; gaps and out-of-order arrival are allowed. Retry the same payload, including clientTimestamp (RFC3339), for the original 201 response and lineId without duplicate writes. Changed payloads or occupied session positions return 409. All writes and identity metadata commit atomically; failed requests can be retried. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Suggestion event with a stable client eventId

bugPercentage	integer
classId	string
clientTimestamp required	string
contextId	string
duration	integer
event required	string (models.SuggestionEvent) Enum: "SUGGESTION_ACCEPT" "SUGGESTION_REJECT" "SUGGESTION_GENERATE" "SUGGESTION_ERROR" "SUGGESTION_LINE_ACCEPT" "SUGGESTION_LINE_REJECT" "SUGGESTION_LINE_GENERATE" "SUGGESTION_LINE_ERROR" "SUGGESTION_SELECTION_GENERATE" "SUGGESTION_SELECTION_ACCEPT" "SUGGESTION_SELECTION_REJECT" "SUGGESTION_SELECTION_ERROR"
eventId required	string
fileName	string
fileText	string
groupId required	string
language	string
lineIndex	integer
required	object (suggestion.LineSuggestion)
sequence required	integer [ 1 .. 9007199254740991 ]
sessionId required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/suggestion-event

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "classId": "string",
• "clientTimestamp": "string",
• "contextId": "string",
• "duration": 0,
• "event": "SUGGESTION_ACCEPT",
• "eventId": "string",
• "fileName": "string",
• "fileText": "string",
• "groupId": "string",
• "language": "string",
• "lineIndex": 0,
• "lineSuggestion": {

  • "correctLine": "string",
  • "incorrectLine": "string",
  • "shownBug": true

  },
• "sequence": 1,
• "sessionId": "string",
• "userId": "string"

}

Response samples

• 201
• 400
• 409
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}

Log a suggestion event idempotently Deprecated

Requires UUIDv4 eventId and sessionId and integer sequence from 1 through 9007199254740991. Session positions are unique per user across ProgSnap, suggestion-event, and run logs; gaps and out-of-order arrival are allowed. Retry the same payload, including clientTimestamp (RFC3339), for the original 201 response and lineId without duplicate writes. Changed payloads or occupied session positions return 409. All writes and identity metadata commit atomically; failed requests can be retried. PUT is canonical. The deprecated POST alias uses the same receipt and payload rules, including when retries switch methods.

Request Body schema: application/json

Suggestion event with a stable client eventId

bugPercentage	integer
classId	string
clientTimestamp required	string
contextId	string
duration	integer
event required	string (models.SuggestionEvent) Enum: "SUGGESTION_ACCEPT" "SUGGESTION_REJECT" "SUGGESTION_GENERATE" "SUGGESTION_ERROR" "SUGGESTION_LINE_ACCEPT" "SUGGESTION_LINE_REJECT" "SUGGESTION_LINE_GENERATE" "SUGGESTION_LINE_ERROR" "SUGGESTION_SELECTION_GENERATE" "SUGGESTION_SELECTION_ACCEPT" "SUGGESTION_SELECTION_REJECT" "SUGGESTION_SELECTION_ERROR"
eventId required	string
fileName	string
fileText	string
groupId required	string
language	string
lineIndex	integer
required	object (suggestion.LineSuggestion)
sequence required	integer [ 1 .. 9007199254740991 ]
sessionId required	string
userId required	string

Responses

https://dev.api.clover.nickrucinski.com/api/v2/logs/suggestion-event

Request samples

• Payload

Content type

application/json

{

• "bugPercentage": 0,
• "classId": "string",
• "clientTimestamp": "string",
• "contextId": "string",
• "duration": 0,
• "event": "SUGGESTION_ACCEPT",
• "eventId": "string",
• "fileName": "string",
• "fileText": "string",
• "groupId": "string",
• "language": "string",
• "lineIndex": 0,
• "lineSuggestion": {

  • "correctLine": "string",
  • "incorrectLine": "string",
  • "shownBug": true

  },
• "sequence": 1,
• "sessionId": "string",
• "userId": "string"

}

Response samples

• 201
• 400
• 409
• 500

Content type

application/json

{

• "property1": "string",
• "property2": "string"

}