Skip to main content
POST
Error

Authorizations

​
Authorization
string
header
required

User JWT token passed in Authorization header

Headers

​
X-Permission-Info
string

Required JWT permission: council_sage (informational only -- enforced server-side)

Path Parameters

​
council_sage_id
string<uuid>
required

UUID of the council sage

Body

application/json
​
council_sage_id
string<uuid>
required

UUID of the council sage

​
context_id
string<uuid>
required

UUID of the context

​
name
string
required

Display name for the sage

​
role
string
required

Role title

​
role_level
string
required

Experience level

​
duration
integer
required

Interview duration in minutes

​
scoring_low
integer
required

Low scoring threshold percentage

​
context
string
default:""

Job description text

​
instructions
string
default:""

Interview instructions

​
tone
string[]

Tone descriptors

​
intro_question
string
default:""

Opening question

​
intro_question_results
string
default:""

Evaluation criteria for intro question

​
scoring_exclude
integer[]
​
scoring_include
integer[]
​
customizable
boolean
default:true

Whether this is a customizable sage (true = full AI pipeline, false = non-customizable)

​
language_code
string | null

Language code for the interview

Response

Workflow run started, generation running asynchronously

Workflow run data from the workflow service