Liya Engine

Personalised, multi-turn career coaching conversation — open-ended advice, goal setting, and accountability.

POST /v1/hiring/coaching-session

Provides a conversational career coaching experience. Unlike structured intents, coaching sessions are open-ended — the candidate drives the topic and the engine responds as a personalised career coach. Use session_id to maintain continuity across turns.

Required inputs

Field	Type	Notes
`input.user_id`	`string`	Your platform's user ID
`input.message`	`string`	Candidate's message or question

Optional inputs

Field	Type	Notes
`input.profile`	`ProfileInput`	Enables personalised, context-aware coaching
`input.resume`	`ResumeInput`	Resume context for advice on applications
`input.career_goals`	`CareerGoalsInput`	Goal context for targeted coaching
`input.session_history`	`SessionHistoryInput`	Auto-managed via `session_id`
`session_id`	`string`	Continue an existing coaching session

Example request

curl -X POST https://api.liyaengine.ai/v1/hiring/coaching-session \
  -H "x-api-key: $LIYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "user_id": "usr_123",
      "message": "I have been passed over for promotion twice. I am not sure what I am doing wrong.",
      "profile": {
        "title": "Senior Engineer",
        "years_of_experience": 6,
        "experience_level": "senior"
      }
    }
  }'

Response

{
  "success": true,
  "data": {
    "output": {
      "message": "That's a frustrating and common experience, and the fact that you're reflecting on it is already a good sign. A few things worth exploring: Do you have visibility into what criteria were used in the promotion decisions? And when you've had conversations with your manager about growth, how specific has the feedback been?",
      "turn": 1,
      "session_active": true,
      "suggested_follow_ups": [
        "I don't really know what the criteria are",
        "My manager gives vague feedback",
        "I think visibility is the issue"
      ]
    },
    "session_id": "ses_coaching_xyz"
  }
}

Persona customisation

Coaching session tone, encouragement level, and persona name are controlled by your tenant's personaConfig:

{
  "personaConfig": {
    "name": "Aria",
    "tone": "friendly",
    "encouragement_level": "high"
  }
}

See Persona Configuration for all options.

Coaching Session

Required inputs

Optional inputs

Example request

Response

Persona customisation

On this page