> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userintuition.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Build research into your product

> Embed AI-moderated interviews in your own product for your own customers with the public API and MCP server.

This page is for teams that run interviews inside their own product, for their own customers. Your application owns the customer experience and how results are presented. User Intuition runs the interviews and returns the evidence.

## Start in the sandbox

Build and test against staging before you touch production. The sandbox has its own dashboard, API, and MCP URLs, uses staging API keys, and disables participant links: preview interviews with Test with AI. See the [sandbox quickstart](https://docs.userintuition.ai/api-reference/staging-quickstart.md).

## Keep each customer's work separate

Give each customer its own organization. A single API key works across every organization its user is an active member of. Name the target organization on every call with the `X-UI-Organization-ID` header; without it, the request acts in the key's default organization. See [organizations and workspace selection](https://docs.userintuition.ai/api-reference/organizations.md) and [API keys](https://docs.userintuition.ai/api-reference/introduction.md#api-keys-recommended).

The API has no endpoint for creating organizations. To provision an organization for each of your customers, [talk to Partnerships](https://www.userintuition.ai/contact/).

## Run the research workflow

[Build a research agent](https://docs.userintuition.ai/api-reference/agents.md) covers the sequence: create a draft, design the plan, choose recruitment, and follow progress and evidence. The [study lifecycle](https://docs.userintuition.ai/api-reference/study-lifecycle.md) lists the state transitions.

## Make your integration reliable

| Need | Where it is documented |
| - | - |
| Retry a create or launch without duplicating it | [Safe retries with `Idempotency-Key`](https://docs.userintuition.ai/api-reference/introduction#safe-retries-for-creating-resources) |
| Stay within request budgets | [Rate limiting](https://docs.userintuition.ai/api-reference/introduction.md#rate-limiting) |
| Receive events and verify they came from User Intuition | [Webhooks and signature verification](https://docs.userintuition.ai/api-reference/webhooks/overview.md) |
| Handle new fields and event types safely | [API versioning](https://docs.userintuition.ai/api-reference/versioning-and-deprecation.md) |

## Billing

Billing is per interview and per organization. Each interview uses credits based on its format; see [billing and credits](https://docs.userintuition.ai/resources/billing-and-credits.md). Whether a completed interview uses credits depends on its [quality rating](https://docs.userintuition.ai/results/calls-and-transcripts.md#quality-ratings).

Each organization has its own credit balance and payment method, so a newly provisioned customer organization starts with no credits. You set your own pricing to your customers on top of User Intuition's.

Use `GET /api/public/v1/usage/interviews` to read interview counts and credits used for an organization; see [reference and usage](https://docs.userintuition.ai/api-reference/reference-and-usage.md).

## Runnable examples

The [developer examples](https://docs.userintuition.ai/api-reference/developer-examples.md) run in fixture mode with no API key or spending:

* [Conduct a study](https://docs.userintuition.ai/api-reference/examples/conduct-a-study.md)
* [Retrieve study results](https://docs.userintuition.ai/api-reference/examples/retrieve-study-results.md)
* [Search research](https://docs.userintuition.ai/api-reference/examples/search-research-example.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.