{"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":"Update a style profile","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":"update-a-style-profile","__idx":0},"children":["Update a style profile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Patch a custom profile. Platform rows are read-only (422). Requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create_assistants"]},". Changing a personality body invalidates cached instructions for assistants that use it. A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind=note"]}," row returns 404 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FEATURE_NOT_ENABLED"]}," when the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["style_notes"]}," beta feature switch is off. When the switch cannot be read right now, a note request returns 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":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"PATCH","path":"https://api.aitronos.com/v1/style-profiles/{profile_id}"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"path-parameters","__idx":1},"children":["Path parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Style profile id (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sty_"]}," + 32 hex characters)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-parameters","__idx":2},"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 used for visibility. Resolved from the caller when omitted."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"body-parameters","__idx":3},"children":["Body parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Display name, 1–100 characters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Picker hint, max 500 characters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Instruction fragment, 1–8000 characters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settings"]}]}," object ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Partial register patch on personality rows. Null clears to defaults. Illegal on notes. Unknown keys and illegal enum values return 422."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_active"]}]}," boolean ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Inactive rows are hidden from pickers and cannot be newly attached."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":4},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The updated ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/objects/style-profile-object"},"children":["Style Profile object"]},"."]}]},{"$$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 PATCH \"https://api.aitronos.com/v1/style-profiles/sty_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\" \\\n  -H \"X-API-Key: $FREDDY_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\": \"Sales voice (v2)\"}'\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\")\nrow = client.style_profiles.update(\n    \"sty_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n    name=\"Sales voice (v2)\",\n)\nprint(row.name)\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.patch(\n    \"https://api.aitronos.com/v1/style-profiles/sty_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n    headers={\n        \"X-API-Key\": os.environ[\"FREDDY_API_KEY\"],\n        \"Content-Type\": \"application/json\",\n    },\n    json={\"is_active\": False},\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/sty_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n  {\n    method: \"PATCH\",\n    headers: {\n      \"X-API-Key\": process.env.FREDDY_API_KEY,\n      \"Content-Type\": \"application/json\",\n    },\n    body: JSON.stringify({ name: \"Sales voice (v2)\" }),\n  },\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  \"id\": \"sty_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\",\n  \"kind\": \"personality\",\n  \"scope\": \"organization\",\n  \"organization_id\": \"org_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n  \"slug\": \"sales_voice\",\n  \"name\": \"Sales voice (v2)\",\n  \"description\": null,\n  \"body\": \"# PERSONALITY\\nYou sell without lying.\",\n  \"settings\": null,\n  \"is_active\": true,\n  \"created_by\": \"usr_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\n  \"created_at\": \"2026-09-14T12:00:00Z\",\n  \"updated_at\": \"2026-09-14T12:05:00Z\"\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":"422 Unprocessable Entity","header":{"title":"422 Unprocessable Entity","controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"PLATFORM_SCOPE_RESTRICTED\",\n    \"message\": \"Shipped personalities cannot be edited. Create a custom one.\",\n    \"system_message\": \"Platform style profiles are read-only\",\n    \"type\": \"validation_error\",\n    \"status\": 422,\n    \"details\": {\"id\": \"sty_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"},\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":5},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/style-profiles/get"},"children":["Get a style profile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/style-profiles/delete"},"children":["Delete a style profile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/objects/style-profile-object"},"children":["Style Profile object"]}]}]}]},"headings":[{"value":"Update a style profile","id":"update-a-style-profile","depth":1},{"value":"Path parameters","id":"path-parameters","depth":2},{"value":"Query parameters","id":"query-parameters","depth":2},{"value":"Body parameters","id":"body-parameters","depth":2},{"value":"Returns","id":"returns","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Update a style profile","description":"PATCH /v1/style-profiles/{profile_id} — patch a custom character or note","keywords":["update style profile","PATCH /v1/style-profiles"],"seo":{"title":"Update a style profile"}},"lastModified":"2026-10-26T18:32:31.692Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/style-profiles/update","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}