---
title: "Architect"
method: POST
path: "/api/architect"
---

# Architect

`POST /api/architect`

## Request

- Base URL: `https://opwhcervi3.execute-api.ca-central-1.amazonaws.com`
- URL: `https://opwhcervi3.execute-api.ca-central-1.amazonaws.com/api/architect`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Namespace Architect: coming soon, included in dxpert Pro. It cannot be run today: an authenticated call answers 409 `product_coming_soon` (an anonymous one 401 `account_required`). No billing, email, or state side effect.

## Headers

- `Authorization` string, nullable
- `X-Api-Key` string, nullable

## Request body

- ArchitectRequest
  - `design` object, nullable
  - `history` ArchitectTurn[]
    - `role` string, required
    - `text` string, required
  - `message` string, required

## Response `200`

Successful Response

- ArchitectResponse
  - `design` object, nullable
  - `quota` object, nullable
  - `reply` string, required

## Other responses

- `401`: `account_required`: no credentials were sent.
- `409`: `product_coming_soon`: the Namespace Architect is coming soon, included in dxpert Pro.
- `422`: Validation Error

---

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