# ConversionLab documentation

> Guides for shipped ConversionLab features and the supported REST API and MCP tools.

- [Use the Agent with your project work](https://conversionlab.app/docs/markdown/ai/agent.md): Ask questions, inspect sources, and review proposed ideas, insights, and experiments.
- [Run and review a pricing page audit](https://conversionlab.app/docs/markdown/ai/audits.md): Capture a page and inspect AI-assisted findings in their original context.
- [Read and discuss today’s brief](https://conversionlab.app/docs/markdown/ai/daily-briefs.md): Use the daily briefing as a starting point for reviewing current work.
- [AI-assisted experiences](https://conversionlab.app/docs/markdown/ai.md): Use the Agent and generated context with deliberate review and team privacy controls.
- [Manage AI availability and retained artifacts](https://conversionlab.app/docs/markdown/ai/privacy.md): Control Team AI Opt-Out and explicitly delete or rebuild retained AI context.
- [Collaborate with comments, attachments, and activity](https://conversionlab.app/docs/markdown/concepts/collaboration.md): Keep discussion and evidence next to the work they describe.
- [Define pages, audiences, labels, and tags](https://conversionlab.app/docs/markdown/concepts/definitions.md): Give project work a consistent vocabulary for targeting, categorization, and filtering.
- [Core concepts](https://conversionlab.app/docs/markdown/concepts.md): Understand the work model and configure the vocabulary your project uses.
- [Define metrics and winning direction](https://conversionlab.app/docs/markdown/concepts/metrics.md): Create meaningful measurement definitions and map provider metrics.
- [Create and manage projects](https://conversionlab.app/docs/markdown/concepts/projects.md): Group related work and manage a project’s name, appearance, and settings.
- [Understand the research and experimentation model](https://conversionlab.app/docs/markdown/concepts/work-model.md): Know when to use observations, insights, learnings, ideas, and experiments.
- [Use documentation in external AI tools](https://conversionlab.app/docs/markdown/developer/ai-readable-docs.md): Copy an article or retrieve Markdown, LLM indexes, and OpenAPI.
- [Use REST queries, uploads, and errors](https://conversionlab.app/docs/markdown/developer/api-conventions.md): Build clients around each endpoint’s supported fields and response contract.
- [Delete attachment](https://conversionlab.app/docs/markdown/developer/api/delete-attachments-attachment.md): DELETE /attachments/{attachment}. Parameters, permissions, request and response schemas.
- [Delete audience](https://conversionlab.app/docs/markdown/developer/api/delete-audiences-audience.md): DELETE /audiences/{audience}. Parameters, permissions, request and response schemas.
- [Delete comment](https://conversionlab.app/docs/markdown/developer/api/delete-comments-comment.md): DELETE /comments/{comment}. Parameters, permissions, request and response schemas.
- [Delete experiment state](https://conversionlab.app/docs/markdown/developer/api/delete-experiment-states-experiment-state.md): DELETE /experiment-states/{experiment_state}. Parameters, permissions, request and response schemas.
- [Delete experiment](https://conversionlab.app/docs/markdown/developer/api/delete-experiments-experiment.md): DELETE /experiments/{experiment}. Parameters, permissions, request and response schemas.
- [Reset survey responses](https://conversionlab.app/docs/markdown/developer/api/delete-forms-form-responses.md): DELETE /forms/{form}/responses. Parameters, permissions, request and response schemas.
- [Delete form](https://conversionlab.app/docs/markdown/developer/api/delete-forms-form.md): DELETE /forms/{form}. Parameters, permissions, request and response schemas.
- [Delete idea state](https://conversionlab.app/docs/markdown/developer/api/delete-idea-states-idea-state.md): DELETE /idea-states/{idea_state}. Parameters, permissions, request and response schemas.
- [Delete idea](https://conversionlab.app/docs/markdown/developer/api/delete-ideas-idea.md): DELETE /ideas/{idea}. Parameters, permissions, request and response schemas.
- [Delete insight label](https://conversionlab.app/docs/markdown/developer/api/delete-insight-labels-insight-label.md): DELETE /insight-labels/{insight_label}. Parameters, permissions, request and response schemas.
- [Delete insight](https://conversionlab.app/docs/markdown/developer/api/delete-insights-insight.md): DELETE /insights/{insight}. Parameters, permissions, request and response schemas.
- [Delete learning](https://conversionlab.app/docs/markdown/developer/api/delete-learnings-learning.md): DELETE /learnings/{learning}. Parameters, permissions, request and response schemas.
- [Delete metric](https://conversionlab.app/docs/markdown/developer/api/delete-metrics-metric.md): DELETE /metrics/{metric}. Parameters, permissions, request and response schemas.
- [Permanently delete an archived observation](https://conversionlab.app/docs/markdown/developer/api/delete-observations-observation-force.md): DELETE /observations/{observation}/force. Parameters, permissions, request and response schemas.
- [Delete observation](https://conversionlab.app/docs/markdown/developer/api/delete-observations-observation.md): DELETE /observations/{observation}. Parameters, permissions, request and response schemas.
- [Delete page](https://conversionlab.app/docs/markdown/developer/api/delete-pages-page.md): DELETE /pages/{page}. Parameters, permissions, request and response schemas.
- [Delete prio model](https://conversionlab.app/docs/markdown/developer/api/delete-prio-models-prio-model.md): DELETE /prio-models/{prio_model}. Parameters, permissions, request and response schemas.
- [Delete project](https://conversionlab.app/docs/markdown/developer/api/delete-projects-project.md): DELETE /projects/{project}. Parameters, permissions, request and response schemas.
- [Delete research collection](https://conversionlab.app/docs/markdown/developer/api/delete-research-collections-research-collection.md): DELETE /research-collections/{research_collection}. Parameters, permissions, request and response schemas.
- [Delete roadmap annotation](https://conversionlab.app/docs/markdown/developer/api/delete-roadmap-annotations-roadmap-annotation.md): DELETE /roadmap-annotations/{roadmap_annotation}. Parameters, permissions, request and response schemas.
- [Delete screen annotation](https://conversionlab.app/docs/markdown/developer/api/delete-screen-annotations-screen-annotation.md): DELETE /screen-annotations/{screen_annotation}. Parameters, permissions, request and response schemas.
- [Delete screen](https://conversionlab.app/docs/markdown/developer/api/delete-screens-screen.md): DELETE /screens/{screen}. Parameters, permissions, request and response schemas.
- [Delete tag](https://conversionlab.app/docs/markdown/developer/api/delete-tags-tag.md): DELETE /tags/{tag}. Parameters, permissions, request and response schemas.
- [Delete variation](https://conversionlab.app/docs/markdown/developer/api/delete-variations-variation.md): DELETE /variations/{variation}. Parameters, permissions, request and response schemas.
- [List activities](https://conversionlab.app/docs/markdown/developer/api/get-activities.md): GET /activities. Parameters, permissions, request and response schemas.
- [Get attachment](https://conversionlab.app/docs/markdown/developer/api/get-attachments-attachment.md): GET /attachments/{attachment}. Parameters, permissions, request and response schemas.
- [List attachments](https://conversionlab.app/docs/markdown/developer/api/get-attachments.md): GET /attachments. Parameters, permissions, request and response schemas.
- [Get audience](https://conversionlab.app/docs/markdown/developer/api/get-audiences-audience.md): GET /audiences/{audience}. Parameters, permissions, request and response schemas.
- [List audiences](https://conversionlab.app/docs/markdown/developer/api/get-audiences.md): GET /audiences. Parameters, permissions, request and response schemas.
- [List comments](https://conversionlab.app/docs/markdown/developer/api/get-comments.md): GET /comments. Parameters, permissions, request and response schemas.
- [Get daily brief](https://conversionlab.app/docs/markdown/developer/api/get-daily-briefs-today.md): GET /daily-briefs/today. Parameters, permissions, request and response schemas.
- [Get experiment state](https://conversionlab.app/docs/markdown/developer/api/get-experiment-states-experiment-state.md): GET /experiment-states/{experiment_state}. Parameters, permissions, request and response schemas.
- [List experiment states](https://conversionlab.app/docs/markdown/developer/api/get-experiment-states.md): GET /experiment-states. Parameters, permissions, request and response schemas.
- [List experiment approvals](https://conversionlab.app/docs/markdown/developer/api/get-experiments-experiment-approvals.md): GET /experiments/{experiment}/approvals. Parameters, permissions, request and response schemas.
- [Get the result report for experiment](https://conversionlab.app/docs/markdown/developer/api/get-experiments-experiment-summary.md): GET /experiments/{experiment}/summary. Parameters, permissions, request and response schemas.
- [Get result time series for experiment](https://conversionlab.app/docs/markdown/developer/api/get-experiments-experiment-timeseries.md): GET /experiments/{experiment}/timeseries. Parameters, permissions, request and response schemas.
- [Get experiment](https://conversionlab.app/docs/markdown/developer/api/get-experiments-experiment.md): GET /experiments/{experiment}. Parameters, permissions, request and response schemas.
- [List experiments](https://conversionlab.app/docs/markdown/developer/api/get-experiments.md): GET /experiments. Parameters, permissions, request and response schemas.
- [Get form](https://conversionlab.app/docs/markdown/developer/api/get-forms-form-response-summary.md): GET /forms/{form}/response-summary. Parameters, permissions, request and response schemas.
- [Export responses for form](https://conversionlab.app/docs/markdown/developer/api/get-forms-form-responses-export.md): GET /forms/{form}/responses/export. Parameters, permissions, request and response schemas.
- [List forms](https://conversionlab.app/docs/markdown/developer/api/get-forms-form-responses.md): GET /forms/{form}/responses. Parameters, permissions, request and response schemas.
- [Get form](https://conversionlab.app/docs/markdown/developer/api/get-forms-form.md): GET /forms/{form}. Parameters, permissions, request and response schemas.
- [List forms](https://conversionlab.app/docs/markdown/developer/api/get-forms.md): GET /forms. Parameters, permissions, request and response schemas.
- [Get idea state](https://conversionlab.app/docs/markdown/developer/api/get-idea-states-idea-state.md): GET /idea-states/{idea_state}. Parameters, permissions, request and response schemas.
- [List idea states](https://conversionlab.app/docs/markdown/developer/api/get-idea-states.md): GET /idea-states. Parameters, permissions, request and response schemas.
- [Get idea](https://conversionlab.app/docs/markdown/developer/api/get-ideas-idea.md): GET /ideas/{idea}. Parameters, permissions, request and response schemas.
- [List ideas](https://conversionlab.app/docs/markdown/developer/api/get-ideas.md): GET /ideas. Parameters, permissions, request and response schemas.
- [Get insight label](https://conversionlab.app/docs/markdown/developer/api/get-insight-labels-insight-label.md): GET /insight-labels/{insight_label}. Parameters, permissions, request and response schemas.
- [List insight labels](https://conversionlab.app/docs/markdown/developer/api/get-insight-labels.md): GET /insight-labels. Parameters, permissions, request and response schemas.
- [Get insight](https://conversionlab.app/docs/markdown/developer/api/get-insights-insight.md): GET /insights/{insight}. Parameters, permissions, request and response schemas.
- [List insights](https://conversionlab.app/docs/markdown/developer/api/get-insights.md): GET /insights. Parameters, permissions, request and response schemas.
- [Get learning](https://conversionlab.app/docs/markdown/developer/api/get-learnings-learning.md): GET /learnings/{learning}. Parameters, permissions, request and response schemas.
- [List learnings](https://conversionlab.app/docs/markdown/developer/api/get-learnings.md): GET /learnings. Parameters, permissions, request and response schemas.
- [Get metric](https://conversionlab.app/docs/markdown/developer/api/get-metrics-metric.md): GET /metrics/{metric}. Parameters, permissions, request and response schemas.
- [List metrics](https://conversionlab.app/docs/markdown/developer/api/get-metrics.md): GET /metrics. Parameters, permissions, request and response schemas.
- [List numbering schemes](https://conversionlab.app/docs/markdown/developer/api/get-numbering-schemes.md): GET /numbering-schemes. Parameters, permissions, request and response schemas.
- [Get observation](https://conversionlab.app/docs/markdown/developer/api/get-observations-observation.md): GET /observations/{observation}. Parameters, permissions, request and response schemas.
- [List observations](https://conversionlab.app/docs/markdown/developer/api/get-observations.md): GET /observations. Parameters, permissions, request and response schemas.
- [Get page](https://conversionlab.app/docs/markdown/developer/api/get-pages-page.md): GET /pages/{page}. Parameters, permissions, request and response schemas.
- [List pages](https://conversionlab.app/docs/markdown/developer/api/get-pages.md): GET /pages. Parameters, permissions, request and response schemas.
- [Get prio model](https://conversionlab.app/docs/markdown/developer/api/get-prio-models-prio-model.md): GET /prio-models/{prio_model}. Parameters, permissions, request and response schemas.
- [List prio models](https://conversionlab.app/docs/markdown/developer/api/get-prio-models.md): GET /prio-models. Parameters, permissions, request and response schemas.
- [Get project](https://conversionlab.app/docs/markdown/developer/api/get-projects-project.md): GET /projects/{project}. Parameters, permissions, request and response schemas.
- [List projects](https://conversionlab.app/docs/markdown/developer/api/get-projects.md): GET /projects. Parameters, permissions, request and response schemas.
- [Get research collection](https://conversionlab.app/docs/markdown/developer/api/get-research-collections-research-collection.md): GET /research-collections/{research_collection}. Parameters, permissions, request and response schemas.
- [List research collections](https://conversionlab.app/docs/markdown/developer/api/get-research-collections.md): GET /research-collections. Parameters, permissions, request and response schemas.
- [Get roadmap annotation](https://conversionlab.app/docs/markdown/developer/api/get-roadmap-annotations-roadmap-annotation.md): GET /roadmap-annotations/{roadmap_annotation}. Parameters, permissions, request and response schemas.
- [List roadmap annotations](https://conversionlab.app/docs/markdown/developer/api/get-roadmap-annotations.md): GET /roadmap-annotations. Parameters, permissions, request and response schemas.
- [Get screen annotation](https://conversionlab.app/docs/markdown/developer/api/get-screen-annotations-screen-annotation.md): GET /screen-annotations/{screen_annotation}. Parameters, permissions, request and response schemas.
- [List screen annotations](https://conversionlab.app/docs/markdown/developer/api/get-screen-annotations.md): GET /screen-annotations. Parameters, permissions, request and response schemas.
- [Get screen](https://conversionlab.app/docs/markdown/developer/api/get-screens-screen.md): GET /screens/{screen}. Parameters, permissions, request and response schemas.
- [List screens](https://conversionlab.app/docs/markdown/developer/api/get-screens.md): GET /screens. Parameters, permissions, request and response schemas.
- [Get tag](https://conversionlab.app/docs/markdown/developer/api/get-tags-tag.md): GET /tags/{tag}. Parameters, permissions, request and response schemas.
- [List tags](https://conversionlab.app/docs/markdown/developer/api/get-tags.md): GET /tags. Parameters, permissions, request and response schemas.
- [List attachments](https://conversionlab.app/docs/markdown/developer/api/get-type-id-attachments.md): GET /{type}/{id}/attachments. Parameters, permissions, request and response schemas.
- [Get the authenticated user](https://conversionlab.app/docs/markdown/developer/api/get-user.md): GET /user. Parameters, permissions, request and response schemas.
- [Get variation](https://conversionlab.app/docs/markdown/developer/api/get-variations-variation.md): GET /variations/{variation}. Parameters, permissions, request and response schemas.
- [List variations](https://conversionlab.app/docs/markdown/developer/api/get-variations.md): GET /variations. Parameters, permissions, request and response schemas.
- [REST API reference](https://conversionlab.app/docs/markdown/developer/api.md): The supported core data and reporting API, generated from the Laravel application.
- [Update attachment](https://conversionlab.app/docs/markdown/developer/api/patch-attachments-attachment.md): PATCH /attachments/{attachment}. Parameters, permissions, request and response schemas.
- [Update audience](https://conversionlab.app/docs/markdown/developer/api/patch-audiences-audience.md): PATCH /audiences/{audience}. Parameters, permissions, request and response schemas.
- [Update comment](https://conversionlab.app/docs/markdown/developer/api/patch-comments-comment.md): PATCH /comments/{comment}. Parameters, permissions, request and response schemas.
- [Update experiment state](https://conversionlab.app/docs/markdown/developer/api/patch-experiment-states-experiment-state.md): PATCH /experiment-states/{experiment_state}. Parameters, permissions, request and response schemas.
- [Update experiment](https://conversionlab.app/docs/markdown/developer/api/patch-experiments-experiment.md): PATCH /experiments/{experiment}. Parameters, permissions, request and response schemas.
- [Update form](https://conversionlab.app/docs/markdown/developer/api/patch-forms-form.md): PATCH /forms/{form}. Parameters, permissions, request and response schemas.
- [Update idea state](https://conversionlab.app/docs/markdown/developer/api/patch-idea-states-idea-state.md): PATCH /idea-states/{idea_state}. Parameters, permissions, request and response schemas.
- [Update idea](https://conversionlab.app/docs/markdown/developer/api/patch-ideas-idea.md): PATCH /ideas/{idea}. Parameters, permissions, request and response schemas.
- [Update insight label](https://conversionlab.app/docs/markdown/developer/api/patch-insight-labels-insight-label.md): PATCH /insight-labels/{insight_label}. Parameters, permissions, request and response schemas.
- [Update insight](https://conversionlab.app/docs/markdown/developer/api/patch-insights-insight.md): PATCH /insights/{insight}. Parameters, permissions, request and response schemas.
- [Update learning](https://conversionlab.app/docs/markdown/developer/api/patch-learnings-learning.md): PATCH /learnings/{learning}. Parameters, permissions, request and response schemas.
- [Update metric](https://conversionlab.app/docs/markdown/developer/api/patch-metrics-metric.md): PATCH /metrics/{metric}. Parameters, permissions, request and response schemas.
- [Update numbering scheme](https://conversionlab.app/docs/markdown/developer/api/patch-numbering-schemes-numberingscheme.md): PATCH /numbering-schemes/{numberingScheme}. Parameters, permissions, request and response schemas.
- [Update observation](https://conversionlab.app/docs/markdown/developer/api/patch-observations-observation.md): PATCH /observations/{observation}. Parameters, permissions, request and response schemas.
- [Update page](https://conversionlab.app/docs/markdown/developer/api/patch-pages-page.md): PATCH /pages/{page}. Parameters, permissions, request and response schemas.
- [Update prio model](https://conversionlab.app/docs/markdown/developer/api/patch-prio-models-prio-model.md): PATCH /prio-models/{prio_model}. Parameters, permissions, request and response schemas.
- [Update project](https://conversionlab.app/docs/markdown/developer/api/patch-projects-project.md): PATCH /projects/{project}. Parameters, permissions, request and response schemas.
- [Update research collection](https://conversionlab.app/docs/markdown/developer/api/patch-research-collections-research-collection.md): PATCH /research-collections/{research_collection}. Parameters, permissions, request and response schemas.
- [Update roadmap annotation](https://conversionlab.app/docs/markdown/developer/api/patch-roadmap-annotations-roadmap-annotation.md): PATCH /roadmap-annotations/{roadmap_annotation}. Parameters, permissions, request and response schemas.
- [Update screen annotation](https://conversionlab.app/docs/markdown/developer/api/patch-screen-annotations-screen-annotation.md): PATCH /screen-annotations/{screen_annotation}. Parameters, permissions, request and response schemas.
- [Update screen](https://conversionlab.app/docs/markdown/developer/api/patch-screens-screen.md): PATCH /screens/{screen}. Parameters, permissions, request and response schemas.
- [Update tag](https://conversionlab.app/docs/markdown/developer/api/patch-tags-tag.md): PATCH /tags/{tag}. Parameters, permissions, request and response schemas.
- [Update variation](https://conversionlab.app/docs/markdown/developer/api/patch-variations-variation.md): PATCH /variations/{variation}. Parameters, permissions, request and response schemas.
- [Create attachment](https://conversionlab.app/docs/markdown/developer/api/post-attachments.md): POST /attachments. Parameters, permissions, request and response schemas.
- [Create audience](https://conversionlab.app/docs/markdown/developer/api/post-audiences.md): POST /audiences. Parameters, permissions, request and response schemas.
- [Create comment](https://conversionlab.app/docs/markdown/developer/api/post-comments.md): POST /comments. Parameters, permissions, request and response schemas.
- [Create experiment state](https://conversionlab.app/docs/markdown/developer/api/post-experiment-states.md): POST /experiment-states. Parameters, permissions, request and response schemas.
- [Apply a bulk action to experiments](https://conversionlab.app/docs/markdown/developer/api/post-experiments-bulk.md): POST /experiments/bulk. Parameters, permissions, request and response schemas.
- [Record experiment approvals](https://conversionlab.app/docs/markdown/developer/api/post-experiments-experiment-approvals.md): POST /experiments/{experiment}/approvals. Parameters, permissions, request and response schemas.
- [Distribute traffic for experiment](https://conversionlab.app/docs/markdown/developer/api/post-experiments-experiment-distribute-traffic.md): POST /experiments/{experiment}/distribute-traffic. Parameters, permissions, request and response schemas.
- [Create experiment](https://conversionlab.app/docs/markdown/developer/api/post-experiments.md): POST /experiments. Parameters, permissions, request and response schemas.
- [Apply a bulk action to forms](https://conversionlab.app/docs/markdown/developer/api/post-forms-bulk.md): POST /forms/bulk. Parameters, permissions, request and response schemas.
- [Duplicate form](https://conversionlab.app/docs/markdown/developer/api/post-forms-duplicate.md): POST /forms/duplicate. Parameters, permissions, request and response schemas.
- [Create form](https://conversionlab.app/docs/markdown/developer/api/post-forms.md): POST /forms. Parameters, permissions, request and response schemas.
- [Create idea state](https://conversionlab.app/docs/markdown/developer/api/post-idea-states.md): POST /idea-states. Parameters, permissions, request and response schemas.
- [Apply a bulk action to ideas](https://conversionlab.app/docs/markdown/developer/api/post-ideas-bulk.md): POST /ideas/bulk. Parameters, permissions, request and response schemas.
- [Create idea](https://conversionlab.app/docs/markdown/developer/api/post-ideas.md): POST /ideas. Parameters, permissions, request and response schemas.
- [Create insight label](https://conversionlab.app/docs/markdown/developer/api/post-insight-labels.md): POST /insight-labels. Parameters, permissions, request and response schemas.
- [Apply a bulk action to insights](https://conversionlab.app/docs/markdown/developer/api/post-insights-bulk.md): POST /insights/bulk. Parameters, permissions, request and response schemas.
- [Create insight](https://conversionlab.app/docs/markdown/developer/api/post-insights.md): POST /insights. Parameters, permissions, request and response schemas.
- [Apply a bulk action to learnings](https://conversionlab.app/docs/markdown/developer/api/post-learnings-bulk.md): POST /learnings/bulk. Parameters, permissions, request and response schemas.
- [Create learning](https://conversionlab.app/docs/markdown/developer/api/post-learnings.md): POST /learnings. Parameters, permissions, request and response schemas.
- [Create metric](https://conversionlab.app/docs/markdown/developer/api/post-metrics.md): POST /metrics. Parameters, permissions, request and response schemas.
- [Backfill identifiers using numbering scheme](https://conversionlab.app/docs/markdown/developer/api/post-numbering-schemes-numberingscheme-backfill.md): POST /numbering-schemes/{numberingScheme}/backfill. Parameters, permissions, request and response schemas.
- [Preview numbering scheme](https://conversionlab.app/docs/markdown/developer/api/post-numbering-schemes-preview.md): POST /numbering-schemes/preview. Parameters, permissions, request and response schemas.
- [Create numbering scheme](https://conversionlab.app/docs/markdown/developer/api/post-numbering-schemes.md): POST /numbering-schemes. Parameters, permissions, request and response schemas.
- [Apply a bulk action to observations](https://conversionlab.app/docs/markdown/developer/api/post-observations-bulk.md): POST /observations/bulk. Parameters, permissions, request and response schemas.
- [Accept observation](https://conversionlab.app/docs/markdown/developer/api/post-observations-observation-accept.md): POST /observations/{observation}/accept. Parameters, permissions, request and response schemas.
- [Dismiss observation](https://conversionlab.app/docs/markdown/developer/api/post-observations-observation-dismiss.md): POST /observations/{observation}/dismiss. Parameters, permissions, request and response schemas.
- [Restore a dismissed observation](https://conversionlab.app/docs/markdown/developer/api/post-observations-observation-restore-dismissal.md): POST /observations/{observation}/restore-dismissal. Parameters, permissions, request and response schemas.
- [Restore an archived observation](https://conversionlab.app/docs/markdown/developer/api/post-observations-observation-restore.md): POST /observations/{observation}/restore. Parameters, permissions, request and response schemas.
- [Create observation](https://conversionlab.app/docs/markdown/developer/api/post-observations.md): POST /observations. Parameters, permissions, request and response schemas.
- [Create page](https://conversionlab.app/docs/markdown/developer/api/post-pages.md): POST /pages. Parameters, permissions, request and response schemas.
- [Recalculate priorities with prio model](https://conversionlab.app/docs/markdown/developer/api/post-prio-models-id-recalculate.md): POST /prio-models/{id}/recalculate. Parameters, permissions, request and response schemas.
- [Validate the formula for prio model](https://conversionlab.app/docs/markdown/developer/api/post-prio-models-validate-formula.md): POST /prio-models/validate-formula. Parameters, permissions, request and response schemas.
- [Create prio model](https://conversionlab.app/docs/markdown/developer/api/post-prio-models.md): POST /prio-models. Parameters, permissions, request and response schemas.
- [Update project](https://conversionlab.app/docs/markdown/developer/api/post-projects-project.md): POST /projects/{project}. Parameters, permissions, request and response schemas.
- [Create project](https://conversionlab.app/docs/markdown/developer/api/post-projects.md): POST /projects. Parameters, permissions, request and response schemas.
- [Update research collection](https://conversionlab.app/docs/markdown/developer/api/post-research-collections-research-collection.md): POST /research-collections/{research_collection}. Parameters, permissions, request and response schemas.
- [Create research collection](https://conversionlab.app/docs/markdown/developer/api/post-research-collections.md): POST /research-collections. Parameters, permissions, request and response schemas.
- [Create roadmap annotation](https://conversionlab.app/docs/markdown/developer/api/post-roadmap-annotations.md): POST /roadmap-annotations. Parameters, permissions, request and response schemas.
- [Create screen annotation](https://conversionlab.app/docs/markdown/developer/api/post-screen-annotations.md): POST /screen-annotations. Parameters, permissions, request and response schemas.
- [Create screen](https://conversionlab.app/docs/markdown/developer/api/post-screens.md): POST /screens. Parameters, permissions, request and response schemas.
- [Create tag](https://conversionlab.app/docs/markdown/developer/api/post-tags.md): POST /tags. Parameters, permissions, request and response schemas.
- [Create variation](https://conversionlab.app/docs/markdown/developer/api/post-variations.md): POST /variations. Parameters, permissions, request and response schemas.
- [Update attachment](https://conversionlab.app/docs/markdown/developer/api/put-attachments-attachment.md): PUT /attachments/{attachment}. Parameters, permissions, request and response schemas.
- [Update audience](https://conversionlab.app/docs/markdown/developer/api/put-audiences-audience.md): PUT /audiences/{audience}. Parameters, permissions, request and response schemas.
- [Update comment](https://conversionlab.app/docs/markdown/developer/api/put-comments-comment.md): PUT /comments/{comment}. Parameters, permissions, request and response schemas.
- [Update experiment state](https://conversionlab.app/docs/markdown/developer/api/put-experiment-states-experiment-state.md): PUT /experiment-states/{experiment_state}. Parameters, permissions, request and response schemas.
- [Reorder experiment states](https://conversionlab.app/docs/markdown/developer/api/put-experiment-states-order.md): PUT /experiment-states/order. Parameters, permissions, request and response schemas.
- [Update experiment](https://conversionlab.app/docs/markdown/developer/api/put-experiments-experiment.md): PUT /experiments/{experiment}. Parameters, permissions, request and response schemas.
- [Update form](https://conversionlab.app/docs/markdown/developer/api/put-forms-form.md): PUT /forms/{form}. Parameters, permissions, request and response schemas.
- [Update idea state](https://conversionlab.app/docs/markdown/developer/api/put-idea-states-idea-state.md): PUT /idea-states/{idea_state}. Parameters, permissions, request and response schemas.
- [Reorder idea states](https://conversionlab.app/docs/markdown/developer/api/put-idea-states-order.md): PUT /idea-states/order. Parameters, permissions, request and response schemas.
- [Update idea](https://conversionlab.app/docs/markdown/developer/api/put-ideas-idea.md): PUT /ideas/{idea}. Parameters, permissions, request and response schemas.
- [Update insight label](https://conversionlab.app/docs/markdown/developer/api/put-insight-labels-insight-label.md): PUT /insight-labels/{insight_label}. Parameters, permissions, request and response schemas.
- [Update insight](https://conversionlab.app/docs/markdown/developer/api/put-insights-insight.md): PUT /insights/{insight}. Parameters, permissions, request and response schemas.
- [Update learning](https://conversionlab.app/docs/markdown/developer/api/put-learnings-learning.md): PUT /learnings/{learning}. Parameters, permissions, request and response schemas.
- [Update metric](https://conversionlab.app/docs/markdown/developer/api/put-metrics-metric.md): PUT /metrics/{metric}. Parameters, permissions, request and response schemas.
- [Update numbering scheme](https://conversionlab.app/docs/markdown/developer/api/put-numbering-schemes-numberingscheme.md): PUT /numbering-schemes/{numberingScheme}. Parameters, permissions, request and response schemas.
- [Update observation](https://conversionlab.app/docs/markdown/developer/api/put-observations-observation.md): PUT /observations/{observation}. Parameters, permissions, request and response schemas.
- [Update page](https://conversionlab.app/docs/markdown/developer/api/put-pages-page.md): PUT /pages/{page}. Parameters, permissions, request and response schemas.
- [Update prio model](https://conversionlab.app/docs/markdown/developer/api/put-prio-models-prio-model.md): PUT /prio-models/{prio_model}. Parameters, permissions, request and response schemas.
- [Update project](https://conversionlab.app/docs/markdown/developer/api/put-projects-project.md): PUT /projects/{project}. Parameters, permissions, request and response schemas.
- [Update research collection](https://conversionlab.app/docs/markdown/developer/api/put-research-collections-research-collection.md): PUT /research-collections/{research_collection}. Parameters, permissions, request and response schemas.
- [Update roadmap annotation](https://conversionlab.app/docs/markdown/developer/api/put-roadmap-annotations-roadmap-annotation.md): PUT /roadmap-annotations/{roadmap_annotation}. Parameters, permissions, request and response schemas.
- [Update screen annotation](https://conversionlab.app/docs/markdown/developer/api/put-screen-annotations-screen-annotation.md): PUT /screen-annotations/{screen_annotation}. Parameters, permissions, request and response schemas.
- [Update screen](https://conversionlab.app/docs/markdown/developer/api/put-screens-screen.md): PUT /screens/{screen}. Parameters, permissions, request and response schemas.
- [Update tag](https://conversionlab.app/docs/markdown/developer/api/put-tags-tag.md): PUT /tags/{tag}. Parameters, permissions, request and response schemas.
- [Update variation](https://conversionlab.app/docs/markdown/developer/api/put-variations-variation.md): PUT /variations/{variation}. Parameters, permissions, request and response schemas.
- [Authenticate and choose the correct permissions](https://conversionlab.app/docs/markdown/developer/authentication.md): Use bearer tokens with team binding, protocol abilities, roles, and plan checks.
- [Build with ConversionLab](https://conversionlab.app/docs/markdown/developer.md): Integrate project data and reporting with your own systems using the REST API.
- [Connect an external AI client with MCP](https://conversionlab.app/docs/markdown/developer/mcp-setup.md): Set up Streamable HTTP, verify team context, and use the supported tool surface.
- [create_experiment](https://conversionlab.app/docs/markdown/developer/mcp/create-experiment.md): Create an experiment. Requires mcp:write and the existing ConversionLab experiment create policy.
- [create_idea](https://conversionlab.app/docs/markdown/developer/mcp/create-idea.md): Create an idea. Requires mcp:write and the existing ConversionLab idea create policy.
- [create_insight](https://conversionlab.app/docs/markdown/developer/mcp/create-insight.md): Create an insight. Requires mcp:write and the existing ConversionLab insight create policy.
- [get_experiment](https://conversionlab.app/docs/markdown/developer/mcp/get-experiment.md): Get a full experiment record with linked summaries and metrics.
- [get_idea](https://conversionlab.app/docs/markdown/developer/mcp/get-idea.md): Get a full idea record with linked summaries.
- [get_insight](https://conversionlab.app/docs/markdown/developer/mcp/get-insight.md): Get a full insight record with linked summaries.
- [get_mcp_context](https://conversionlab.app/docs/markdown/developer/mcp/get-mcp-context.md): Describe the authenticated ConversionLab team, user role, MCP token permissions, and available MCP surface.
- [get_metric](https://conversionlab.app/docs/markdown/developer/mcp/get-metric.md): Get a metric by ID.
- [get_project](https://conversionlab.app/docs/markdown/developer/mcp/get-project.md): Get a project by ID.
- [get_today_daily_brief](https://conversionlab.app/docs/markdown/developer/mcp/get-today-daily-brief.md): Return today's retained daily brief if one already exists. This never generates a new brief.
- [MCP tool reference](https://conversionlab.app/docs/markdown/developer/mcp.md): Inputs, outputs, permissions, and examples for every registered ConversionLab MCP tool.
- [list_audiences](https://conversionlab.app/docs/markdown/developer/mcp/list-audiences.md): List configured audiences, optionally filtered by project.
- [list_experiment_states](https://conversionlab.app/docs/markdown/developer/mcp/list-experiment-states.md): List experiment states, optionally filtered by project.
- [list_experiments](https://conversionlab.app/docs/markdown/developer/mcp/list-experiments.md): List experiments, optionally filtered by project, state, type, or metric.
- [list_idea_states](https://conversionlab.app/docs/markdown/developer/mcp/list-idea-states.md): List idea states, optionally filtered by project.
- [list_ideas](https://conversionlab.app/docs/markdown/developer/mcp/list-ideas.md): List ideas, optionally filtered by project or state.
- [list_insight_labels](https://conversionlab.app/docs/markdown/developer/mcp/list-insight-labels.md): List insight labels, optionally filtered by project.
- [list_insights](https://conversionlab.app/docs/markdown/developer/mcp/list-insights.md): List insights, optionally filtered by project or label.
- [list_metrics](https://conversionlab.app/docs/markdown/developer/mcp/list-metrics.md): List metrics, optionally filtered by project.
- [list_pages](https://conversionlab.app/docs/markdown/developer/mcp/list-pages.md): List configured pages, optionally filtered by project.
- [list_projects](https://conversionlab.app/docs/markdown/developer/mcp/list-projects.md): List projects in the authenticated team.
- [search_conversionlab](https://conversionlab.app/docs/markdown/developer/mcp/search-conversionlab.md): Search ConversionLab projects, ideas, insights, experiments, metrics, pages, and audiences. Uses semantic search only when team AI is available, otherwise falls back to keyword search.
- [update_experiment](https://conversionlab.app/docs/markdown/developer/mcp/update-experiment.md): Update an experiment. Requires mcp:write and the existing ConversionLab experiment update policy.
- [update_idea](https://conversionlab.app/docs/markdown/developer/mcp/update-idea.md): Update an idea. Requires mcp:write and the existing ConversionLab idea update policy.
- [update_insight](https://conversionlab.app/docs/markdown/developer/mcp/update-insight.md): Update an insight. Requires mcp:write and the existing ConversionLab insight update policy.
- [Review experimentation activity in Analytics](https://conversionlab.app/docs/markdown/experiments/analytics.md): Use signals, execution balance, and detailed operational metrics.
- [Experiments and results](https://conversionlab.app/docs/markdown/experiments.md): Plan experiments, map the data, and review the outcome in context.
- [Plan and document an experiment](https://conversionlab.app/docs/markdown/experiments/plan.md): Record a hypothesis, dates, metrics, research, and the next decision.
- [Read experiment results](https://conversionlab.app/docs/markdown/experiments/results.md): Interpret descriptive totals, analysis status, variant effects, and traffic checks.
- [Plan work on the roadmap](https://conversionlab.app/docs/markdown/experiments/roadmap.md): Review experiment timing and add context that affects interpretation.
- [Manage variations and traffic allocation](https://conversionlab.app/docs/markdown/experiments/variations.md): Set a control, describe alternatives, and maintain the planned allocation.
- [Create an account or join a team](https://conversionlab.app/docs/markdown/getting-started/account-access.md): Register, accept an invitation, verify your email, and recover access.
- [Find and organize your work](https://conversionlab.app/docs/markdown/getting-started/finding-your-work.md): Navigate teams, projects, lists, filters, detail pages, and bulk actions.
- [Getting started](https://conversionlab.app/docs/markdown/getting-started.md): Set up your account and team, then connect your first workflow.
- [Connect your first research-to-experiment workflow](https://conversionlab.app/docs/markdown/getting-started/quick-start.md): Follow one small example from evidence to a documented experiment.
- [Complete Team Setup](https://conversionlab.app/docs/markdown/getting-started/team-setup.md): Prepare the project, AI choice, pages, audiences, and metrics for your team.
- [Ideas and prioritization](https://conversionlab.app/docs/markdown/ideas.md): Build a useful backlog and decide which ideas deserve attention.
- [Capture ideas and connect the evidence](https://conversionlab.app/docs/markdown/ideas/manage-ideas.md): Build an idea backlog with research, pages, metrics, and experiment links.
- [Score ideas with a priority model](https://conversionlab.app/docs/markdown/ideas/prioritize.md): Choose a project model, define inputs, and compare idea scores consistently.
- [Customize idea and experiment states](https://conversionlab.app/docs/markdown/ideas/states.md): Describe your workflow with named states and experiment categories.
- [Overview](https://conversionlab.app/docs/markdown/index.md): Practical guides for connecting research, ideas, experiments, and everything you learn along the way.
- [Import existing work from Airtable](https://conversionlab.app/docs/markdown/integrations/airtable-import.md): Authorize a base, review mappings, run an import, and inspect the results.
- [Review behavioral signals from Microsoft Clarity](https://conversionlab.app/docs/markdown/integrations/clarity.md): Connect Clarity, sync behavioral evidence, and review suggested observations.
- [Integrations and imports](https://conversionlab.app/docs/markdown/integrations.md): Connect vendor tools or bring existing source data into the right project.
- [Send project activity alerts to Slack](https://conversionlab.app/docs/markdown/integrations/slack.md): Connect a Slack channel and choose which project activities generate alerts.
- [Connect a testing platform and map experiments](https://conversionlab.app/docs/markdown/integrations/testing-platforms.md): Bring provider data into ConversionLab with deliberate project and variation mapping.
- [Understand research collections and screen evidence](https://conversionlab.app/docs/markdown/research/evidence.md): Keep source context with observations, screen annotations, and collections.
- [Research](https://conversionlab.app/docs/markdown/research.md): Capture observations, explain insights, and preserve what your team has learned.
- [Turn observations into insights](https://conversionlab.app/docs/markdown/research/insights.md): Explain a research finding and connect it to evidence and future work.
- [Preserve what the team has learned](https://conversionlab.app/docs/markdown/research/learnings.md): Write reusable conclusions with confidence, timing, and supporting insights.
- [Capture and review observations](https://conversionlab.app/docs/markdown/research/observations.md): Record source evidence and review suggested observations before using them.
- [Build a feedback survey](https://conversionlab.app/docs/markdown/surveys/build.md): Create questions, organize the visitor experience, and save your survey.
- [Surveys](https://conversionlab.app/docs/markdown/surveys.md): Build feedback surveys, publish them on your website, and review the answers.
- [Publish and target a survey](https://conversionlab.app/docs/markdown/surveys/publish.md): Install the project widget and control when, where, and how a survey appears.
- [Review, export, and reset survey answers](https://conversionlab.app/docs/markdown/surveys/responses.md): Read summaries and individual responses, export the selected status, and manage test data.
- [Manage an agency and client workspaces](https://conversionlab.app/docs/markdown/team-administration/agency-clients.md): Keep client work isolated while reviewing delivery across your agency.
- [Create and revoke API keys](https://conversionlab.app/docs/markdown/team-administration/api-keys.md): Give scripts and external AI clients scoped access to one team.
- [Manage plans, usage, and billing](https://conversionlab.app/docs/markdown/team-administration/billing.md): Understand plan limits, subscription changes, and read-only access.
- [Team administration](https://conversionlab.app/docs/markdown/team-administration.md): Manage people, projects, organization identity, plans, and credentials.
- [Update the organization name and logo](https://conversionlab.app/docs/markdown/team-administration/organization.md): Keep the team identity recognizable in the application.
- [Manage members, invitations, and roles](https://conversionlab.app/docs/markdown/team-administration/people-and-roles.md): Give each teammate the access they need in the intended workspace.
- [Manage your profile and notifications](https://conversionlab.app/docs/markdown/team-administration/profile-notifications.md): Update personal details and decide which activity alerts you receive.
- [Configure readable IDs with taxonomy](https://conversionlab.app/docs/markdown/team-administration/taxonomy.md): Set team numbering and optional project-specific sequences for work items.
- [Fix sign-in, permission, and saving problems](https://conversionlab.app/docs/markdown/troubleshooting/access-and-saving.md): Identify whether a failure comes from the session, team role, plan, or form fields.
- [Troubleshooting](https://conversionlab.app/docs/markdown/troubleshooting.md): Find the cause of access, data, survey, and reporting problems.
- [Find missing work or integration data](https://conversionlab.app/docs/markdown/troubleshooting/missing-data.md): Check location, filters, review state, mappings, and sync status.
- [Resolve experiment report warnings](https://conversionlab.app/docs/markdown/troubleshooting/results.md): Restore reporting readiness without hiding data or allocation problems.
- [Fix a survey that does not appear](https://conversionlab.app/docs/markdown/troubleshooting/survey-widget.md): Check activation, installation, targeting, triggers, frequency, and competing surveys.

## Machine-readable references

- [OpenAPI](https://conversionlab.app/docs/openapi.json)
- [MCP tools](https://conversionlab.app/docs/mcp.json)
- [All documentation](https://conversionlab.app/docs/llms-full.txt)