Job Roles
Find Similar Job Roles
Soft duplicate-detection at create time. Returns up to 3 active roles in the same org whose titles overlap with title. Used by the create-role form to surface a non-blocking "similar role exists" banner so recruiters don't fragment the candidate pipeline by accidentally creating "Sr PD" and "Senior Product Designer" as separate roles.
Matching is intentionally simple (case-insensitive substring in either direction, plus exact match). Doesn't catch abbreviation differences like "Sr" vs "Senior" — fuzzy matching via pg_trgm is a future iteration once we see real-world false negatives.
get/api/job-roles/similar
Request
- Base URL: https://api.thebetterhire.ai (the document declares no server; this is the origin it was published from)
- URL: https://api.thebetterhire.ai/api/job-roles/similar
- Auth: HTTP bearer
Query parameters
titlestring required
Response
Successful Response
unknown required
Changes
No recorded changes to this operation across all 1 revision of this API.