Skip to main content

Rename profile

POST /api/organizations/{org_id}/profiles/{name}/rename

Rename an LLM profile, cascading the rename to any Agent Profiles that reference it. The SDK rename_llm_profile renames the LLM profile and repoints every agent_profiles.*.llm_profile_ref == name to new_name under the org row lock, so a referencing Agent Profile never dangles. Both collections are written back in the same transaction.

Parameters

NameInTypeRequiredDescription
org_idpath`stringnull`yes
namepathstringyes

Request body

FieldTypeRequiredDescription
new_namestringyes

Responses

StatusDescription
200Successful Response
422Validation Error

Response body

FieldTypeRequiredDescription
namestringyes
messagestringyes

Operation ID: rename_profile_api_organizations__org_id__profiles__name__rename_post