Coaching Session
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.