Liya Engine

Open-ended career and workplace conversation — questions, advice, and information not covered by a structured intent.

POST /v1/hiring/general-chat

A conversational fallback for career-related questions that don't map to a specific structured intent. The engine responds as a knowledgeable career assistant. Useful for building chat UIs where users ask free-form questions.

Required inputs

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

Optional inputs

Field	Type	Notes
`input.profile`	`ProfileInput`	Enables contextualised answers
`input.resume`	`ResumeInput`	Resume context
`input.career_goals`	`CareerGoalsInput`	Goal context
`input.session_history`	`SessionHistoryInput`	Conversation history via `session_id`
`session_id`	`string`	Continue a session

Example request

curl -X POST https://api.liyaengine.ai/v1/hiring/general-chat \
  -H "x-api-key: $LIYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "user_id": "usr_123",
      "message": "What is the difference between a staff engineer and an engineering manager?"
    }
  }'

Response

{
  "success": true,
  "data": {
    "output": {
      "message": "Both are senior roles but they represent two different career tracks...",
      "turn": 1,
      "session_active": true
    },
    "session_id": "ses_chat_abc"
  }
}

When to use general-chat vs coaching-session

	`general-chat`	`coaching-session`
Best for	Questions, factual answers, quick advice	Ongoing, personal coaching relationship
Session memory	Optional	Recommended — memory improves coaching quality
Output structure	Conversational message	Message + suggested follow-ups + session state
Tone	Informative	Empathetic and goal-oriented

General Chat

Required inputs

Optional inputs

Example request

Response

When to use general-chat vs coaching-session

On this page