---
title: "Try Algenta — no API key required"
method: POST
path: "/v1/playground"
tags: ["Playground"]
---

# Try Algenta — no API key required

`POST /v1/playground`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/playground`
- Auth: none declared

**No sign-up. No API key. Just try it.**

Run a decision analysis, optimization, simulation, or forecast in one API call. Rate limited at 10 requests/minute per IP.

Upgrade your configured dashboard for:
- 500 simulations/month free
- Up to 1,000,000 scenarios per request
- All 12 engines

## Request body

- PlaygroundRequest: Describe what you want to analyze. No statistics knowledge required. Modes: decision → What should I do? Returns proceed/pause/reject + why optimize → Find the best value. Returns optimal config + improvement simulate → What's the range of outcomes? Returns distribution forecast → What will happen? Returns future periods with CI Example: { "mode": "decision", "inputs": {"revenue": 120000, "cost": 70000}, "runs": 1000 }
  - `mode` string: What to run: decision, optimize, simulate, forecast
  - `inputs` object: Your input variables as name → value (or name → {value, low, high})
  - `objective` string: What to optimize (for optimize mode): 'maximize profit', 'minimize cost', etc.
  - `runs` integer: Scenarios to evaluate (playground cap: 5,000 — upgrade for 1,000,000+)
  - `history` number[], nullable: Historical values for forecast mode (most recent last, min 3)

## Response `200`

Successful Response

- PlaygroundResponse
  - `playground_id` string, required
  - `mode` string, required
  - `action` string, required
  - `value` number, required
  - `confidence` number, required
  - `why` string[], required
  - `details` object, required
  - `latency_ms` number, required
  - `upgrade_hint` string, required

## Other responses

- `422`: Validation Error

---

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