Updates an existing position and returns the full updated position object. This is a partial update — include only the fields you want to change; any field not on the position's editable-fields list is silently dropped from the request.

Note: type, education, experience, category, and location.country/location.state are validated against Breezy's configured value lists and return 400 if invalid. pipeline_id, scorecard_id, and questionnaire_id, if provided, are checked for existence and return 404 if the id is not found. department and category are also checked against the company's configured departments/categories. salary (from, to, currency, period) is validated and converted into the position's internal salary_range; period may be one of the legacy period names (Hourly, Daily, Weekly, Biweekly, Monthly, Yearly) or a company-defined salary term.