CvdsPositionMetadata

The position-config object a search plans against (the position_metadata field on POST /api/v1/cvds/search). This is the same shape CV DeepMatch consumes as its requirements config — see the CvDeepMatchRequirements schema and the Position config reference for the complete field-by-field contract (the 1–5 importance scale, where each requirement belongs, education ON/OFF, the language-config quirks, and the cardinality limits).

The API requires only that position_metadata be a non-empty object — the inner shape is the matching/search engine's contract, not validated field-by-field at this layer. Typically it carries a name and a requirements block:

{
  "name": "Senior Backend Engineer",
  "requirements": {
    "workExperience": { "from": 5, "to": 10, "importance": 5, "relevant_industries": ["SaaS"], "industries_config": [{ "name": "SaaS", "importance": 5 }] },
    "skills": { "importance": 5, "skills_config": { "hard_skills": [{ "name": "Node.js", "importance": 5 }], "requirements": { "minimal_qualifications": true, "preferable_qualifications": true } } }
  }
}

property name*any

{
  "name": "Senior Backend Engineer",
  "requirements": {
    "workExperience": { "from": 5, "to": 10, "importance": 5, "relevant_industries": ["SaaS"], "industries_config": [{ "name": "SaaS", "importance": 5 }] },
    "skills": { "importance": 5, "skills_config": { "hard_skills": [{ "name": "Node.js", "importance": 5 }], "requirements": { "minimal_qualifications": true, "preferable_qualifications": true } } }
  }
}

Example:

{"name":"Senior Backend Engineer","requirements":{"workExperience":{"from":5,"to":10,"importance":5,"relevant_industries":["SaaS","Fintech"],"industries_config":[{"name":"SaaS","importance":5},{"name":"Fintech","importance":4}]},"skills":{"importance":5,"skills_config":{"hard_skills":[{"name":"Node.js","importance":5}],"requirements":{"minimal_qualifications":true,"preferable_qualifications":true}}}}}

CvdsPositionMetadata
{
  "name": "Senior Backend Engineer",
  "requirements": {
    "workExperience": {
      "from": 5,
      "to": 10,
      "importance": 5,
      "relevant_industries": [
        "SaaS",
        "Fintech"
      ],
      "industries_config": [
        {
          "name": "SaaS",
          "importance": 5
        },
        {
          "name": "Fintech",
          "importance": 4
        }
      ]
    },
    "skills": {
      "importance": 5,
      "skills_config": {
        "hard_skills": [
          {
            "name": "Node.js",
            "importance": 5
          }
        ],
        "requirements": {
          "minimal_qualifications": true,
          "preferable_qualifications": true
        }
      }
    }
  }
}