Hypotize

Hypotize Experiments API

Ideas, tests in the pipeline and their outcomes. An idea is an experiment in the Idea status.

GitHub OpenAPI

Operations 7

GET /projects/{project_id}/experiments List experiments #
POST /projects/{project_id}/ideas Create an idea #
POST /projects/{project_id}/experiments/import Import experiments #
GET /experiments/{experiment_id} Get an experiment #
PATCH /experiments/{experiment_id} Update an experiment #
POST /experiments/{experiment_id}/transition Move an experiment to a stage #
POST /experiments/{experiment_id}/outcome Record an outcome #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/hypotize-ai/openapi/hypotize-ai-experiments-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/hypotize-ai:hypotize-ai-experiments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

hypotize-ai-experiments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Hypotize Experiments API
  version: 1.0.0
  summary: Growth experiments for agents and automations.
  description: 'Read and write the growth experiments of your Hypotize projects: ideas, tests, outcomes and learnings.


    Authenticate with a personal API key (Settings, API keys) sent as `Authorization: Bearer hyp_...`. A Read only key can call the GET endpoints; a Read and write key can also call the others.


    Errors use real HTTP status codes and one body shape: `{ "error": { "code", "message" } }`, sometimes with extra fields such as `required_roles` or the import row that failed.


    - 400 INVALID_REQUEST, INVALID_JSON, INVALID_CURSOR, INVALID_IDEMPOTENCY_KEY and the lifecycle codes (EXPERIMENT_NOT_READY, OUTCOME_REQUIRED...)

    - 401 UNAUTHORIZED: missing, invalid, revoked or expired API key

    - 403 FORBIDDEN (the key''s access level is too low) or INSUFFICIENT_ROLE (the project role is too low, with required_roles)

    - 404 NOT_FOUND

    - 409 STALE_EXPERIMENT (expected_updated_at is not the current updated_at) or IDEMPOTENCY_KEY_REUSED

    - 429 RATE_LIMITED: 300 requests a minute per key, 500 written rows every 5 minutes


    Writes accept an `Idempotency-Key` header: a retry with the same key and body within 24 hours returns the first response, with the header `Idempotent-Replayed: true`.


    Lists are paginated with `cursor`: pass `next_cursor` from the previous page until it is null.


    The same operations are available to AI agents on the MCP server at https://api.hypotize.ai/mcp.'
  contact:
    name: Hypotize
    url: https://hypotize.ai
    email: hello@hypotize.ai
  termsOfService: https://hypotize.ai/terms
servers:
- url: https://api.hypotize.ai/v1
security:
- apiKey: []
tags:


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/hypotize-ai/openapi/hypotize-ai-experiments-api-openapi.yml