App öffnen
Moonborn — API · personas

Create a persona via the 6-step generation pipeline

Runs intent_parse → soul_draft → self_enrich → mask_build → surface_ground → audit. When `stream=true`, the response is `text/event-stream` (handled by C3 SSE).

POST/v1/personasscope · Bearer (API key or session JWT)
Request body
FieldTypeDescription
intentreqstring
workspaceIdreqstring
slugstring
visibilitystring · "private" | "workspace" | "org" | "public"default: "workspace"
languagestringdefault: "en"
streambooleandefault: false

Responses

201Persona created
Body
FieldTypeDescription
idreqstring
statusreqstring · "draft" | "active" | "archived" | "deleted"
pipelineRunIdreqstring
422Validation error
Body
FieldTypeDescription
errorreqobject
error.codereqstring
error.messagereqstring
429Rate limit exceeded
Body
FieldTypeDescription
errorreqobject
error.codereqstring
error.messagereqstring

Examples

cURL
curl -X POST https://api.moonborn.co/v1/personas \
  -H "Authorization: Bearer $MOONBORN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "intent": "<string>",
      "workspaceId": "<string>"
    }'
TypeScript
import Moonborn from '@moonborn/sdk';

const client = new Moonborn({ apiKey: process.env.MOONBORN_API_KEY });

const result = await client.personas.createPersona({
  intent: "<string>",
  workspaceId: "<string>",
});
Python
import os
from moonborn import Moonborn

client = Moonborn(api_key=os.environ["MOONBORN_API_KEY"])

result = client.personas.create_persona(
    intent="<string>",
    workspace_id="<string>",
)