add_ai_topic
ChatGPTAdd one topic to the end of an AI interview's discussion guide. Drafts only.
add_screener_option
ChatGPTAdd an answer option, with its qualification type, to a screener question. Drafts only.
add_screener_questions
ChatGPTAdd one or more screener questions to a draft study, keeping the existing ones. The result lists each question added, with its id and options, and each one rejected, with the reason. Drafts only.
add_screener_skip_logic
ChatGPTAdd a branching rule to a screener question: when the answer matches, jump to a later screener question or end the screener. Conditions name the exact option text. Drafts only.
add_survey_questions
ChatGPTAdd one or more questions to a draft survey, keeping the existing ones. The result lists each question added, with its id, and each one rejected, with the reason. Drafts only.
add_survey_skip_logic
ChatGPTAdd a branching rule to a survey question: after it is answered, jump to a later question or end the survey, or show or skip questions with a conditional rule. A question's rules are checked in the order they were added and the first match wins. Drafts only.
add_task
ChatGPTAdd a task to a draft unmoderated study: a live website, the study's connected Figma prototype, or a video diary. Drafts only.
check_launch_readiness
ChatGPTWhat a study still needs before it can launch: blocking errors, warnings and progress.
clear_targeting
ChatGPTClear some or all of a draft study's recruitment filters. Drafts only.
create_study_draft
ChatGPTCreate a new DRAFT study in this workspace. Nothing launches and nobody is contacted. Returns the draft id, a CleverX link, launch readiness and the price.
delete_screener_question
ChatGPTDelete a screener question from a draft study. Drafts only.
delete_screener_skip_logic
ChatGPTDelete every branching rule on a screener question. Drafts only.
delete_survey_question
ChatGPTDelete a question from a draft survey. Drafts only.
delete_survey_skip_logic
ChatGPTDelete the branching rules on a survey question: all of them, or one by its ruleId. Drafts only.
delete_task
ChatGPTDelete a task from a draft unmoderated study. Drafts only.
estimate_price
ChatGPTPrice of a study as configured: incentives, CleverX platform fee in credits, project total. Owners and Admins also see whether today's balances cover it.
get_answers_by_question
ChatGPTAI interviews only. Without topicIndex: the discussion guide as numbered topics and how many interviews reached each. With topicIndex: what each participant said under that topic, with times and citations (search narrows it).
get_attention
ChatGPTAcross all studies: drafts not launched yet, live studies with no new responses for N days, and people waiting for your approval.
get_completion_timeline
ChatGPTCompletions per day over the last N days (default 30, up to 90), the 7-day pace and the projected finish date.
get_highlights
ChatGPTMoments the research team flagged in recordings and transcripts: time, note, tags and who flagged them. Archived highlights are left out unless archived=true.
get_meetings
ChatGPTA study's interview meetings, filtered by state, date range or moderator, with paging.
get_participant_summary
ChatGPTHow many participants are at each stage of a study: screening, qualified, disqualified, in progress, completed, failed or terminated.
get_participants
ChatGPTA study's participants (short names, no contact details), filtered by status, search text, recruitment source or date range, with paging (limit, skip).
get_recruitment_progress
ChatGPTRecruitment against the target: quotas, completed and remaining counts, split by recruitment source.
get_response_distribution
ChatGPTHow participants answered survey questions: pass questionId, or questionIds for several in one call. With includeRespondents=true and one questionId: who answered what (short names), with text search on open answers and paging.
get_screener_analytics
ChatGPTScreener answers: with no parameters, how answers are spread per question; with surveyRequestId or surveyRequestIds, those participants' answers. compareAll=true puts up to 30 participants side by side in one call, best for comparing candidates.
get_screener_questions
ChatGPTThe study's screener questions, their options, which answers qualify or disqualify, and their order.
get_sessions
ChatGPTA study's sessions (participant attempts), filtered by status, participant or date range, with paging. Finished sessions include each task's outcome.
get_study_activity
ChatGPTEvents on a study (participants invited, screened, completed, status changes, payouts). Pass since (ISO timestamp) to poll for everything that happened after your last look, oldest first, with nextCursor for continuation.
get_study_analysis
ChatGPTThe study's AI analysis: executive summary, key findings, themes, quotes and recommendations. Pass section to get one part.
get_study_counts
ChatGPTHow many studies this connection can see, by status and by type, in one call.
get_study_overview
ChatGPTOne study at a glance: status, type, dates, participant and response counts, setup, audience filters and recruitment settings.
get_study_setup
ChatGPTA study's builder view: its tasks with taskIds, AI interviewer settings, saved targeting, or the allowed AI voices.
get_study_spend
ChatGPTWhat one study has cost so far: total, credits used, incentives paid, invoices and payouts. Team owner and Admins only.
get_survey_questions
ChatGPTThe study's survey or interview questions, with options, question types and skip logic.
get_task_results
ChatGPTTask results across finished sessions: attempts, completion and success rates, average time in seconds, and per task who succeeded, gave up or got stuck (with the last page reached on website tasks). detailLevel adds per-participant metrics.
get_team_activity
ChatGPTRecent events across every study this connection can see, each tagged with its study. Pass since to poll for new events.
get_transcript
ChatGPTTranscript of one session or meeting (sessionId or meetingId), or several sessions at once (sessionIds): AI-interview conversation, think-aloud and video responses, filterable by keyword, speaker or task.
get_wallet
ChatGPTCredits and USD balance available to launch studies in this workspace. Team owner and Admins only.
list_studies
ChatGPTBrowse the studies this connection can see, newest first, 20 per page (limit up to 100) with the total matching count; narrow with status, type, query (title) or updatedSince instead of paging. Each item carries its id, the studyId of that study.
remove_ai_topic
ChatGPTRemove one topic, chosen by its index, from an AI interview's discussion guide. Drafts only.
remove_screener_option
ChatGPTRemove one answer option, chosen by its 0-based index, from a screener question. Drafts only.
reorder_screener_questions
ChatGPTPut a draft study's screener questions in a new order, given their ids. Drafts only.
reorder_survey_questions
ChatGPTPut a draft survey's questions in a new order, given their ids. Drafts only.
reorder_tasks
ChatGPTPut a draft study's tasks in a new order, given their taskIds. Drafts only.
replace_ai_topics
ChatGPTReplace an AI interview's whole discussion guide with a new ordered list of topics. The result estimates the guide's length against the study's target. Drafts only.
search_targeting_options
ChatGPTFind valid job titles, industries or locations for targeting.
set_ai_follow_up_depth
ChatGPTSet how many follow-up questions the AI interviewer asks, from light to deep. Drafts only.
set_ai_interview_format
ChatGPTChoose whether a draft AI interview records audio only or video with the camera. Drafts only.
set_ai_intro_message
ChatGPTSet what the AI interviewer says when a participant joins. Drafts only.
set_ai_language
ChatGPTSet the language the AI interviewer speaks; the result says whether the voice changed to match it. Drafts only.
set_ai_moderation_style
ChatGPTSet the AI interviewer's moderation style: conversational, structured or probing. Drafts only.
set_ai_role_context
ChatGPTSet the AI interviewer's persona, tone and rules, which participants never see. Drafts only.
set_ai_voice
ChatGPTSet the AI interviewer's voice, speaking pace or tone for a draft AI interview. Drafts only.
set_targeting
ChatGPTSet who a draft study recruits: B2B job titles, industries, seniority, company size and locations, or B2C demographics. Send only the filters to change; a list replaces the saved one, and job titles, industries and locations must be catalog values. Drafts only.
update_ai_topic
ChatGPTChange one discussion-guide topic, chosen by its index; fields left out stay as they are. Drafts only.
update_screener_option
ChatGPTChange the text or qualification type of one screener answer option, chosen by its 0-based index. Drafts only.
update_screener_question
ChatGPTChange a screener question's text, type, options or settings (required, randomize, grid or scale properties, selection, character limit). Drafts only.
update_study_draft
ChatGPTChange a draft study's basics: title, description, persona, welcome message, audience type, length, participant count, incentive and dates. Drafts only.
update_survey_question
ChatGPTChange a survey question's text, options, settings or qualification (which answers disqualify). Drafts only.
update_task
ChatGPTChange a task's title, instructions, website URL, follow-up questions or its website, prototype or video settings; send only what changes. Prototype screens and attachments are set in CleverX. Drafts only.
whoami
ChatGPTIdentify the user, team and role behind this connection, and the scopes granted.