---
title: "Create an experiment"
method: POST
path: "/api/v1/experiments"
tags: ["Experiments"]
---

# Create an experiment

`POST /api/v1/experiments`

## Request

- Base URL: `https://www.specky.space`
- URL: `https://www.specky.space/api/v1/experiments`
- Auth: HTTP bearer

## Request body

- CreateExperimentRequest
  - `hypothesis` string, required
  - `method` 'interview' | 'survey' | 'prototype' | 'a_b_test' | 'fake_door' | 'concierge' | 'wizard_of_oz' | 'analytics' | 'other', required
  - `description` string
  - `success_criteria` string
  - `effort` 'low' | 'medium' | 'high'
  - `time_to_run` string

## Response `200`

Successful response. Always includes `summary` (string) and `ok: true`; mutating endpoints additionally include the created resource id under a tool-specific key.

- OkSummary
  - `ok` true
  - `summary` string: Human-readable result text.

## Other responses

- `401`: Missing or invalid bearer token

---

[API](https://skmtc.dev/specky/apis/specky-api.md) · [All operations](https://skmtc.dev/specky/apis/specky-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specky/apis/specky-api/revisions/bed1995f892c?raw)