Reference

API and concurrency

The HTTP contract for validated resources and revision-safe updates.

# API and concurrency

The HTTP contract for validated resources and revision-safe updates.

The React app talks to the Hono API under /api/v1. Every response is parsed at the browser boundary with Zod.

## Revision-safe writes

Stored resources carry a positive revision. Updates and deletes send If-Match so an older browser cannot silently replace a newer administrator change.

## Credential redaction

Public API resources never include credential references. They expose only credentialConfigured, while secret resolution stays in server-side adapters.

```http
PUT /api/v1/tenants/:tenantId/workspaces/:workspaceId/skills/:skillId
If-Match: "3"
Content-Type: application/json
```

The React app talks to the Hono API under /api/v1. Every response is parsed at the browser boundary with Zod.

#Revision-safe writes

Stored resources carry a positive revision. Updates and deletes send If-Match so an older browser cannot silently replace a newer administrator change.

#Credential redaction

Public API resources never include credential references. They expose only credentialConfigured, while secret resolution stays in server-side adapters.

PUT /api/v1/tenants/:tenantId/workspaces/:workspaceId/skills/:skillId
If-Match: "3"
Content-Type: application/json