Generate AI Questions | Gradii API Documentation

curl -X POST https://gradii.ai/api/v2/question-banks/id/generate \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "questionType": "mcq",
  "topic": "React Hooks",
  "category": "Technical",
  "totalQuestions": 5,
  "difficulty": "Medium",
  "subCategory": "Frontend",
  "programmingLanguage": "javascript",
  "skills": [
    "React",
    "JavaScript"
  ]
}'

{
  "success": true,
  "data": {
    "generated": 5,
    "questions": [
      {
        "id": "q_ai_123",
        "questionType": "mcq",
        "question": "What is the purpose of useEffect hook?",
        "aiGenerated": true
      }
    ]
  },
  "message": "Successfully generated 5 questions",
  "timestamp": "2024-01-28T10:30:00.000Z",
  "version": "2.0"
}

Generate questions using AI for a specific question bank

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequiredformat: "uuid"

Question bank ID

Request

This endpoint expects an object.

questionTypestringRequired

mcq|coding|behavioral|combo

topicstringRequired

Topic for questions

categorystringRequired

Response

Questions generated successfully

successbooleanOptional

dataobjectOptional

messagestringOptional

timestampstringOptional

versionstringOptional

Errors

400

Bad Request Error

404

Not Found Error

500

Internal Server Error