Create Campaign - Step 3 | Gradii API Documentation

curl -X POST https://gradii.ai/api/v2/job-campaigns/create/step3 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "campaignId": "123e4567-e89b-12d3-a456-426614174000",
  "enableSkillScoring": true,
  "skills": [
    {
      "name": "JavaScript",
      "proficiencyLevel": "advanced",
      "weight": 30,
      "isRequired": true,
      "description": "Strong JavaScript fundamentals"
    },
    {
      "name": "React",
      "proficiencyLevel": "expert",
      "weight": 20,
      "isRequired": true
    }
  ],
  "enableCompetencyScoring": true,
  "competencies": [
    {
      "name": "Problem Solving",
      "weight": 20,
      "isRequired": true,
      "description": "Ability to solve complex problems",
      "scoringMethod": "ai"
    }
  ],
  "enableEducationScoring": true,
  "education": [
    {
      "name": "Bachelor'\''s Degree in Computer Science",
      "weight": 10,
      "isRequired": false
    }
  ],
  "enableExperienceScoring": true,
  "experience": [
    {
      "name": "Full Stack Development",
      "weight": 20,
      "isRequired": true,
      "minimumYears": 6
    }
  ],
  "enableOtherScoring": false,
  "otherScoring": []
}'

{
  "success": true,
  "data": {
    "campaignId": "123e4567-e89b-12d3-a456-426614174000",
    "step": 3,
    "scoringParameters": [
      {
        "id": "param-uuid-1",
        "parameterType": "skill",
        "parameterName": "JavaScript",
        "weight": 30,
        "proficiencyLevel": "advanced",
        "isRequired": true,
        "scoringMethod": "ai"
      }
    ],
    "summary": {
      "totalParameters": 5,
      "totalWeight": 100,
      "requiredParameters": 4,
      "categorySummary": {
        "skills": 2,
        "competencies": 1,
        "education": 1,
        "experience": 1,
        "other": 0
      }
    }
  },
  "message": "Scoring parameters configured successfully",
  "timestamp": "2024-01-28T10:30:00.000Z",
  "version": "2.0"
}

Create job campaign - Step 3: Scoring Parameters (Configure candidate evaluation criteria)

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

campaignIdstringRequiredformat: "uuid"

Campaign ID from Step 1

enableSkillScoringbooleanOptional

Enable skill-based scoring (default: true)

skillslist of anyOptional

Array of skill requirements

enableCompetencyScoringbooleanOptional

Enable competency scoring (default: true)

competencieslist of anyOptional

Array of competency requirements

enableEducationScoringbooleanOptional

Enable education scoring (default: true)

educationlist of anyOptional

Array of education requirements

enableExperienceScoringbooleanOptional

Enable experience scoring (default: true)

experiencelist of anyOptional

Array of experience requirements

enableOtherScoringbooleanOptional

Enable other scoring criteria (default: false)

otherScoringlist of anyOptional

Array of other scoring criteria

Response

Scoring parameters configured successfully

successbooleanOptional

dataobjectOptional

messagestringOptional

timestampstringOptional

versionstringOptional

Errors

400

Bad Request Error