---
title: "kwnva.design API documentation"
description: "HTTP API, auth, sandbox, and deprecation for kwnva.design"
canonical: https://kwnva.design/docs
last-updated: 2026-08-30
---

# kwnva.design API documentation

The kwnva.design catalog is a versioned REST API at `/api/v1`. Reads are anonymous. Optional tokens come from `POST /api/v1/keys` or `POST /oauth/register`.

## Quickstart

```
GET https://kwnva.design/api/v1/projects
GET https://kwnva.design/api/v1/projects/palermo
GET https://kwnva.design/api/v1/search?q=brand
POST https://kwnva.design/api/v1/keys
GET https://kwnva.design/sandbox
```

## Authentication

See https://kwnva.design/auth.md. Authorization-server metadata: https://kwnva.design/.well-known/oauth-authorization-server and https://kwnva.design/.well-known/openid-configuration.

## Errors

Every operation in https://kwnva.design/openapi.json references `#/components/responses/Error` (and RateLimited). Bodies are application/problem+json with type, title, status, detail, code, and hint.

## Versioning and deprecation

URL path versions. Retired versions send HTTP Deprecation and Sunset headers. Policy: https://kwnva.design/deprecation.md and https://kwnva.design/api/versioning.md.

## MCP

Product (do surface): https://kwnva.design/mcp
Product aliases: https://kwnva.design/api/mcp · https://kwnva.design/do · https://kwnva.design/product/mcp
Docs (learn surface): https://kwnva.design/mcp/docs
Cards: https://kwnva.design/.well-known/mcp/server-card.json and https://kwnva.design/.well-known/mcp/docs/server-card.json
Official registry: https://registry.modelcontextprotocol.io/v0.1/servers/design.kwnva%2Fportfolio/versions/latest
Glama: https://glama.ai/mcp/connectors/design.kwnva/portfolio