Home / Resources / API reference
Developers

API reference

Integrate walorenz.ai into your own tools. Generate concepts, retrieve results and export documents programmatically over a simple REST API.

Base URL

BASE https://api.walorenz.ai/v1

All requests are made over HTTPS and return JSON. Authenticate with a Bearer API key from your account settings.

Authentication

Pass your API key as a Bearer token in the Authorization header.

curl
# every request includes your key
curl https://api.walorenz.ai/v1/concepts \
  -H "Authorization: Bearer $WALORENZ_API_KEY"

Create a concept

POST /v1/concepts

Submit a plain-language brief and receive a generated automation concept.

request
POST /v1/concepts
{
  "brief": "Automate a bottle-filling line: 3 stations, 60 units/min,
           fill-level check, reject faulty units, HMI on the floor.",
  "units": "metric"
}
200 OK
{
  "id": "cpt_8fJ2a",
  "status": "ready",
  "parts": 14,
  "controller": "S7-1500",
  "bom_estimate_eur": 18400,
  "confidence": 0.92
}

Retrieve a concept

GET /v1/concepts/{id}

Fetch a previously generated concept, including its full component list and reasoning.

curl
curl https://api.walorenz.ai/v1/concepts/cpt_8fJ2a \
  -H "Authorization: Bearer $WALORENZ_API_KEY"

List concepts

GET /v1/concepts

List concepts in your workspace, most recent first. Supports limit and cursor pagination.

Export a concept

POST /v1/concepts/{id}/export

Render a concept as a branded proposal (PDF) or a structured BOM (CSV).

request
POST /v1/concepts/cpt_8fJ2a/export
{ "format": "pdf", "template": "proposal" }