Skip to content
Last updated

Update a style profile

Patch a custom profile. Platform rows are read-only (422). Requires create_assistants. Changing a personality body invalidates cached instructions for assistants that use it. A kind=note row returns 404 FEATURE_NOT_ENABLED when the style_notes beta feature switch is off. When the switch cannot be read right now, a note request returns 503 STYLE_NOTES_SWITCH_UNRESOLVED with a Retry-After header: retry, do not treat it as off.

PATCHhttps://api.aitronos.com/v1/style-profiles/{profile_id}

Path parameters

profile_id string required

Style profile id (sty_ + 32 hex characters).

Query parameters

organization_id string optional

Organization used for visibility. Resolved from the caller when omitted.

Body parameters

name string optional

Display name, 1–100 characters.

description string optional

Picker hint, max 500 characters.

body string optional

Instruction fragment, 1–8000 characters.

settings object optional

Partial register patch on personality rows. Null clears to defaults. Illegal on notes. Unknown keys and illegal enum values return 422.

is_active boolean optional

Inactive rows are hidden from pickers and cannot be newly attached.

Returns

The updated Style Profile object.

cURL
curl -X PATCH "https://api.aitronos.com/v1/style-profiles/sty_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Sales voice (v2)"}'