{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["api-container","api-content","endpoint","api-examples","tabs","tab","code-group"]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"List style profiles","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"list-style-profiles","__idx":0},"children":["List style profiles"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List platform catalog rows plus this organization's custom characters and turn notes. Any authenticated organization member can list. Filter with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=personality"]}," for the assistant picker or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=note"]}," for composer chips."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=note"]}," requires the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["style_notes"]}," beta feature switch. When the switch is off, that filter returns 404 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FEATURE_NOT_ENABLED"]}," and an unfiltered list omits note rows. When the switch cannot be read right now, both return 503 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STYLE_NOTES_SWITCH_UNRESOLVED"]}," with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retry-After"]}," header: retry, do not treat it as off. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=personality"]}," never reads the switch and is unaffected."]},{"$$mdtype":"Tag","name":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"GET","path":"https://api.aitronos.com/v1/style-profiles"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-parameters","__idx":1},"children":["Query parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Organization to list custom rows for. Resolved from the caller when omitted."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personality"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]},". Omit to return both. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]}," is gated on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["style_notes"]}," beta feature switch (404 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FEATURE_NOT_ENABLED"]}," when off, 503 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STYLE_NOTES_SWITCH_UNRESOLVED"]}," when it cannot be read)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active_only"]}]}," boolean ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}," · Defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", hide inactive custom rows. Platform rows are always active."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["assistant_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resolve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default_voice"]}," for this assistant. Omit for the platform default. An assistant this caller cannot use returns 422 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATION_ERROR"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.field = \"assistant_id\""]},", the same refusal ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/responses/create"},"children":["Create response"]}," gives. A deleted assistant of this organization is not refused: its threads still send, with the platform default, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default_voice"]}," is the platform default."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":2},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/objects/style-profile-object"},"children":["Style Profile list"]}," with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," array."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reads that can carry note rows (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=note"]},", or no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind"]},") also return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["intensities"]}," — the ordered steps a composer draws for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["style_notes[].intensity"]}," on ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/responses/create"},"children":["Create response"]},". Each step is a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}," to send back verbatim and a reader-facing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]},"; the first step is the one a new chip opens at. The array is empty on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=personality"]}," reads and while the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["style_notes"]}," switch is off."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same reads return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["selection"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"multi\""]},": one turn may carry several notes) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_items"]}," (the most notes one ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["style_notes"]}," list accepts; more is a 422). Both are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," whenever ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["intensities"]}," is empty."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every read returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default_voice"]},": the character a turn plays when no note is picked, as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ \"id\", \"slug\", \"name\", \"description\", \"source\" }"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["assistant"]}," when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["assistant_id"]}," has a personality, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["platform"]}," for the platform default (Witty) otherwise. It is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," only when that assistant has no personality but a custom register, so its voice is no catalog character."]}]},{"$$mdtype":"Tag","name":"ApiExamples","attributes":{},"children":[{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Request","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"dropdown"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl -X GET \"https://api.aitronos.com/v1/style-profiles?kind=personality&active_only=true\" \\\n  -H \"X-API-Key: $FREDDY_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python SDK","header":{"title":"Python SDK","controls":{"copy":{}}},"source":"from aitronos import Aitronos\n\nclient = Aitronos(api_key=\"your-api-key\")\nresult = client.style_profiles.list(kind=\"personality\", active_only=True)\nfor row in result.data:\n    print(f\"{row.slug}: {row.id}\")\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"import os\nimport requests\n\nresponse = requests.get(\n    \"https://api.aitronos.com/v1/style-profiles\",\n    headers={\"X-API-Key\": os.environ[\"FREDDY_API_KEY\"]},\n    params={\"kind\": \"note\", \"active_only\": True},\n)\nprint(response.json())\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","data-title":"JavaScript","header":{"title":"JavaScript","controls":{"copy":{}}},"source":"const response = await fetch(\n  \"https://api.aitronos.com/v1/style-profiles?kind=note&active_only=true\",\n  { headers: { \"X-API-Key\": process.env.FREDDY_API_KEY } },\n);\nconsole.log(await response.json());\n","lang":"javascript"},"children":[]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"200 OK","header":{"title":"200 OK","controls":{"copy":{}}},"source":"{\n  \"data\": [\n    {\n      \"id\": \"sty_ef235ebd9c34eac3d8196137a22f181e\",\n      \"kind\": \"personality\",\n      \"scope\": \"platform\",\n      \"organization_id\": null,\n      \"slug\": \"witty\",\n      \"name\": \"Witty\",\n      \"description\": \"Sharp, funny, human. Platform default.\",\n      \"body\": \"# PERSONALITY\\nYou speak like a sharp, grounded friend who still does the work.\",\n      \"settings\": {\n        \"profanity\": \"when_fitting\",\n        \"lecturing\": \"never\",\n        \"adult\": \"avoid\",\n        \"candor\": \"direct\",\n        \"dark_humor\": \"off\"\n      },\n      \"is_active\": true,\n      \"is_default\": true,\n      \"created_by\": null,\n      \"created_at\": \"2026-09-14T12:00:00Z\",\n      \"updated_at\": \"2026-09-14T12:00:00Z\"\n    }\n  ],\n  \"default_personality_id\": \"sty_ef235ebd9c34eac3d8196137a22f181e\",\n  \"intensities\": [],\n  \"selection\": null,\n  \"max_items\": null,\n  \"default_voice\": {\n    \"id\": \"sty_ef235ebd9c34eac3d8196137a22f181e\",\n    \"slug\": \"witty\",\n    \"name\": \"Witty\",\n    \"description\": \"Sharp, funny, human. Platform default.\",\n    \"source\": \"platform\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Error","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"404 FEATURE_NOT_ENABLED","header":{"title":"404 FEATURE_NOT_ENABLED","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FEATURE_NOT_ENABLED\",\n    \"message\": \"Style notes are not enabled for this organization.\",\n    \"system_message\": \"Style notes are not enabled\",\n    \"type\": \"client_error\",\n    \"status\": 404,\n    \"details\": {\"reason\": \"style_notes is off\"},\n    \"trace_id\": \"req_abc123xyz\",\n    \"timestamp\": \"2026-09-16T12:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"503 STYLE_NOTES_SWITCH_UNRESOLVED","header":{"title":"503 STYLE_NOTES_SWITCH_UNRESOLVED","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"STYLE_NOTES_SWITCH_UNRESOLVED\",\n    \"message\": \"Style notes could not be loaded right now. Please try again.\",\n    \"system_message\": \"Feature switch 'style_notes' could not be read; refusing to report style notes as off\",\n    \"type\": \"service_unavailable\",\n    \"status\": 503,\n    \"details\": {\"feature\": \"style_notes\", \"retry_after\": 2},\n    \"trace_id\": \"req_abc123xyz\",\n    \"timestamp\": \"2026-10-03T12:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"401 Unauthorized","header":{"title":"401 Unauthorized","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"AUTHENTICATION_REQUIRED\",\n    \"message\": \"Authentication is required.\",\n    \"system_message\": \"Missing or invalid credentials\",\n    \"type\": \"authentication_error\",\n    \"status\": 401,\n    \"details\": {},\n    \"trace_id\": \"req_abc123xyz\",\n    \"timestamp\": \"2026-09-14T12:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":3},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/objects/style-profile-object"},"children":["Style Profile object"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/style-profiles/create"},"children":["Create a style profile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/assistants/create"},"children":["Create assistant"]}]}]}]},"headings":[{"value":"List style profiles","id":"list-style-profiles","depth":1},{"value":"Query parameters","id":"query-parameters","depth":2},{"value":"Returns","id":"returns","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"List style profiles","description":"GET /v1/style-profiles — platform catalog plus this organization's custom rows","keywords":["style profiles","personality catalog","style notes","GET /v1/style-profiles"],"seo":{"title":"List style profiles"}},"lastModified":"2026-10-26T18:32:31.692Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/style-profiles/list","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}