Ask a question about the candidate

Ask any natural language question about the candidate's skills, experience, projects, background, or behavioral tendencies. Use this for conversational questions like "What is your TypeScript experience?" or "How do you approach testing?"

post/query

Request

  • Base URL: https://agent.yuens.me
  • URL: https://agent.yuens.me/query
  • Auth: none declared

Request body

questionstring required

The question to ask about the candidate

contextstring

Optional extra context (e.g. role being hired for)

Response

Answer grounded in the candidate's profile data

answerstring
confidence'high' | 'medium' | 'low'
sourcesstring[]
project_slugsstring[]
follow_up_suggestionsstring[]
fit_questionboolean

True when the question asked about the candidate's fit/suitability for a role and was answered in prose (narrate-first). Clients with an interactive fit-check flow should offer it as an explicit follow-up when this is true.

Changes

No recorded changes to this operation across all 1 revision of this API.