# Neuron Personas API

**Canonical:** https://apis.io/apis/neuron-ng/neuron-ng-personas-api/  
**Provider:** Neuron — https://apis.io/providers/neuron-ng/  
**Base URL:** https://api.neuron.ng/api/v1  
**Documentation:** https://neuron.ng/docs

Neuron Personas API is one of 25 APIs that [Neuron](https://apis.io/providers/neuron-ng/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Personas. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Voice studio — distill a reusable voice (voiceProfile + exemplars) from a Collection of mined content, generate content in that voice, and apply the voice to a bot's persona.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/personas` | List voice personas |
| POST | `/personas` | Create a persona manually |
| POST | `/personas/build` | Distill a voice from a Collection's top-engagement content (needs ≥3 samples) |
| GET | `/personas/{id}` | Get a persona |
| PUT | `/personas/{id}` | Update a persona (name/description/voiceProfile/exemplars) |
| DELETE | `/personas/{id}` | Delete a persona |
| POST | `/personas/{id}/generate` | Generate content in the persona's voice (returns N variations) |
| POST | `/personas/{id}/apply-to-bot` | Merge the persona's voice into a bot's system prompt (idempotent) |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/neuron-ng/openapi/neuron-ng-personas-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/neuron-ng/json-schema/neuron-ng-persona-schema.json

## Other Neuron APIs (12)

- [Neuron Account API](https://apis.io/apis/neuron-ng/neuron-ng-account-api-api/)
- [Neuron Approvals API](https://apis.io/apis/neuron-ng/neuron-ng-approvals-api/)
- [Neuron Audit API](https://apis.io/apis/neuron-ng/neuron-ng-audit-api/)
- [Neuron Auth API](https://apis.io/apis/neuron-ng/neuron-ng-auth-api/)
- [Neuron Billing API](https://apis.io/apis/neuron-ng/neuron-ng-billing-api/)
- [Neuron Blog API](https://apis.io/apis/neuron-ng/neuron-ng-blog-api/)
- [Neuron Bot API](https://apis.io/apis/neuron-ng/neuron-ng-bot-api-api/)
- [Neuron Bot Setup API](https://apis.io/apis/neuron-ng/neuron-ng-bot-setup-api/)
- [Neuron Bots API](https://apis.io/apis/neuron-ng/neuron-ng-bots-api/)
- [Neuron Builtin Tools API](https://apis.io/apis/neuron-ng/neuron-ng-builtin-tools-api/)
- [Neuron Channels API](https://apis.io/apis/neuron-ng/neuron-ng-channels-api/)
- [Neuron Conversations API](https://apis.io/apis/neuron-ng/neuron-ng-conversations-api/)

## Tags

Personas

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/neuron-ng` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/neuron-ng/neuron-ng-personas-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/neuron-ng/.
