edubridge learning management system
POST /api/v1/cats/{id}/new-attempt

Creates a new attempt for a student to take the CAT. Students can only attempt if within the allowed time window and attempt limits.

Path parameters

  • id string Required

    CAT ID to attempt

Responses

  • 201 application/json

    CAT attempt started successfully

  • 400

    Cannot start attempt - CAT not available, time window passed, or attempt limit exceeded

  • 404

    CAT not found

POST /api/v1/cats/{id}/new-attempt 
curl \
 --request POST 'https://api.echoplain.social/api/v1/cats/123e4567-e89b-12d3-a456-426614174000/new-attempt'
Response examples (201) 
{
  "attempt": {
    "id": "789e0123-e89b-12d3-a456-426614174002",
    "catId": "123e4567-e89b-12d3-a456-426614174000",
    "status": "IN_PROGRESS",
    "startedAt": "2025-10-15T09:30:00.000Z",
    "studentId": "student123",
    "attemptNumber": 1
  },
  "message": "CAT attempt started successfully"
}