Skip to main content

Delete profile

DELETE /api/organizations/{org_id}/profiles/{name}

Delete an LLM profile. Blocked with 409 if any of the org's Agent Profiles still reference this LLM profile by llm_profile_ref (the SDK find_referrers FK guard) — both collections live on the same org row, so the SELECT ... FOR UPDATE lock makes the referrer check and the delete atomic.

Parameters​

NameInTypeRequiredDescription
org_idpath`stringnull`yes
namepathstringyes—

Responses​

StatusDescription
200Successful Response
422Validation Error

Response body​

FieldTypeRequiredDescription
namestringyes—
messagestringyes—

Operation ID: delete_profile_api_organizations__org_id__profiles__name__delete