| Tool | Description |
|---|---|
list_studies | List your studies |
get_study | Fetch a single study (always call BEFORE update_study) |
create_study | Create a new study (requires is_panel — Panel vs BYOP, see below) |
update_study | PATCH a study (screener_questions REPLACES the full list) |
delete_study | Soft-delete a study |
stop_panels | Cancel all active panel surveys for a study |
upload_concept_link | Add a concept-test external link (dedups by label) |
delete_concept_link | Remove a concept-test link by id |
list_available_panel_questions | Catalog of standard panel screener questions ({id, name}; call BEFORE adding panel screeners) |
get_panel_question | Fetch one panel question with its answer options — needed to disqualify on a specific answer (e.g. Job Title = CEO) |
list_available_languages | Supported voice/interview ISO language codes |
list_available_modes | Voice / chat / video mode catalog |
list_study_types | Catalog of study TYPES (Win/Loss, Churn, NPS+CSAT, Onboarding, Brand Health, etc.) with per-user recommended_slug |
get_study_type | Fetch a single study type by slug |
Response shaping
Response shaping.get_study returns a lean summary by default:
view—"summary"(default) or"full"(raw record).include— array of heavy fields to expand, e.g.["screener_questions"].fields— exact allowlist of top-level fields (idalways returned); overridesview/include.
include or view: "full" to fetch the omitted data.
Panel vs BYOP study type
Every study is one of two types, set by the requiredis_panel flag on create_study:
- Panel study (
is_panel: true) — respondents are recruited from the paid panel. Only Panel studies can field a panel viacreate_panel. Respondent rewards are handled by the panel — don’t setincentive_amount; the reward cost/hold is previewed by thecreate_paneldry-run. - BYOP study (
is_panel: false) — “bring your own participant”: you invite your own participants viacreate_invite.create_panelis not available. Incentives are BYOP-only: setincentive_amount/is_offering_enabled, then pay completers viasend_reward.
is_panel is required, an agent should ask the user which type they want before calling create_study.
How User Intuition handles this
Studies are the central object in User Intuition’s research platform — every interview, screener, and panel order flows through them. Uselist_study_types and list_available_modes to configure the right study shape before calling create_study. See /platform/agentic-research/ for how agents orchestrate the full study lifecycle end to end.
