List platform catalog rows plus this organization's custom characters and turn notes. Any authenticated organization member can list. Filter with kind=personality for the assistant picker or kind=note for composer chips.
kind=note requires the style_notes beta feature switch. When the switch is off, that filter returns 404 FEATURE_NOT_ENABLED and an unfiltered list omits note rows. When the switch cannot be read right now, both return 503 STYLE_NOTES_SWITCH_UNRESOLVED with a Retry-After header: retry, do not treat it as off. kind=personality never reads the switch and is unaffected.
organization_id string optional
Organization to list custom rows for. Resolved from the caller when omitted.
kind string optional
personality or note. Omit to return both. note is gated on the style_notes beta feature switch (404 FEATURE_NOT_ENABLED when off, 503 STYLE_NOTES_SWITCH_UNRESOLVED when it cannot be read).
active_only boolean optional · Defaults to true
When true, hide inactive custom rows. Platform rows are always active.
assistant_id string optional
Resolve default_voice for this assistant. Omit for the platform default. An assistant this caller cannot use returns 422 VALIDATION_ERROR with details.field = "assistant_id", the same refusal Create response gives. A deleted assistant of this organization is not refused: its threads still send, with the platform default, so default_voice is the platform default.
A Style Profile list with a data array.
Reads that can carry note rows (kind=note, or no kind) also return intensities — the ordered steps a composer draws for style_notes[].intensity on Create response. Each step is a value to send back verbatim and a reader-facing label; the first step is the one a new chip opens at. The array is empty on kind=personality reads and while the style_notes switch is off.
The same reads return selection ("multi": one turn may carry several notes) and max_items (the most notes one style_notes list accepts; more is a 422). Both are null whenever intensities is empty.
Every read returns default_voice: the character a turn plays when no note is picked, as { "id", "slug", "name", "description", "source" }. source is assistant when assistant_id has a personality, and platform for the platform default (Witty) otherwise. It is null only when that assistant has no personality but a custom register, so its voice is no catalog character.
- Bash
- Python
- Python
- JavaScript
curl -X GET "https://api.aitronos.com/v1/style-profiles?kind=personality&active_only=true" \
-H "X-API-Key: $FREDDY_API_KEY"