Activate agent profile
POST /api/agent-profiles/{profile_id}/activate
Activate a profile for the calling member — pointer only. Writes the per-member OrgMember.active_agent_profile_id and nothing else (no agent_settings materialization, and the profiles collection itself is untouched — the transaction helper skips the write-back when nothing mutated; #15044 §3). Member-facing, so it requires only VIEW_ORG_SETTINGS (each member picks their own active profile); profile CRUD requires EDIT_ORG_SETTINGS. 404 if no stored profile has that id.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
profile_id | path | string | yes | — |
org_id | query | `string | null` | no |
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
Response body
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | — |
message | string | yes | — |
agent_settings_applied | boolean | no | — |
Operation ID: activate_agent_profile_api_agent_profiles__profile_id__activate_post