Skip to main content

Delete an agent profile

POST 
/api/v1/agent-profiles/delete

Deletes the profile from the current library without checking whether conversations still reference it. Resolve dependent conversations before deletion.

  • If it was the project's defaultProfileId, that pointer is cleared.
  • Direct sends on conversations still naming it in activeProfileId fail with ACTIVE_PROFILE_NOT_FOUND. Select an enabled replacement or restore the profile. A disabled replacement fails with ACTIVE_PROFILE_DISABLED. Queued messages can fall back to defaults and log the problem; see unusable profiles.
  • Historical version records remain. Their retention does not prove that every dependent turn remains reproducible.

Request​

Responses​

Profile deleted

Document ID: DOC-MA-profiles-prompts-api-deleteAgentProfile. Section identities and revisions.

SectionStable reference
OverviewDOC-MA-profiles-prompts-api-deleteAgentProfile#overview
RequestDOC-MA-profiles-prompts-api-deleteAgentProfile#request
ResponsesDOC-MA-profiles-prompts-api-deleteAgentProfile#responses