Skip to content

Positions

Job definitions that configure AI interviews: skills, duration, expiry, and role context.

Key APIs

MethodPathPurpose
POST/v1/positionsCreate position
GET/v1/positionsList with filters and interview counts
GET/v1/positions/:idDetail with interview count
PATCH/v1/positions/:idUpdate fields
POST/v1/positions/:id/archiveArchive position

Business Rules

  • Skill count is capped by interview duration rules on create/update.
  • Scheduling requires position status active (enforced in interviews).
  • Archive is a status change, not a hard delete.

Dependencies

None

Sophia AI Interview Platform — Internal Documentation