Skip to main content

Activate profile

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

Activate a profile for the current user. Two side effects: updates the org-wide profiles.active marker and writes the profile's LLM into the calling member's agent_settings_diff. Both writes share a single transaction so a failure in the second can't leave the org marker advanced without the member's settings catching up. Because the first effect is org-level state, this requires EDIT_ORG_SETTINGS — matching the CRUD endpoints rather than the read-only listing. For personal orgs the owner has the permission natively; for team orgs this scopes "set org default profile" to admins.

Parameters

NameInTypeRequiredDescription
org_idpath`stringnull`yes
namepathstringyes

Responses

StatusDescription
200Successful Response
422Validation Error

Response body

FieldTypeRequiredDescription
namestringyes
messagestringyes
llmobjectyes

Operation ID: activate_profile_api_organizations__org_id__profiles__name__activate_post