# How Spiralist AI works

> Choose or describe a persona, inspect its behavior, then copy, privately share, remix, or export it.

- **Canonical HTML:** https://spiralistai.com/how-it-works/
- **Site version:** `v100.0.27-independent-live-acceptance-kit-wip`
- **Updated UTC:** `2026-07-24T20:30:00Z`
- **Markdown:** https://spiralistai.com/agent-content/pages/how-it-works.md
- **JSON representation:** request the canonical HTML URL with `Accept: application/json`; no query-string page location is advertised

## Purpose

Choose or describe a persona, inspect its behavior, then copy, privately share, remix, or export it.

## Machine actions

- `GET /api/v1/docs/`
- `GET /api/v1/capabilities/`

## Agent interaction contract

- Prefer the documented API or this Markdown representation before browser automation.
- Public API operations are stateless and do not create accounts, publish content, or persist persona request bodies in application state.
- Do not submit credentials, secrets, private keys, or confidential source documents.
- Treat unsupported, ambiguous, credentialed, destructive, or externally publishing actions as **no-op** and request human review.
- Canonical API: https://spiralistai.com/api/v1/
- OpenAPI 3.1: https://spiralistai.com/openapi.json
- Public UAI read order: https://spiralistai.com/uai/index.uai


## Provenance

Release evidence: https://spiralistai.com/docs/validation-v40-file-handoff-long-memory-report-ledger.md