Skip to content

session/setPermissionProfile

Experimental

Selects a preconfigured permission profile mid-session; select, never create.

Type: SessionSetPermissionProfileParams

session/setPermissionProfile params: change the profile of a loaded durable session through the existing authenticated permission-controller transaction. A standard command; the actor identity is the command attribution session/setApprovalMode already uses.

Select, never create. A client selects a profile the host catalog already admits (ExecutionPolicyProjection::permission_profiles); it may not construct one or supply inline rules — there is no inline-rule member and none may be added under this contract.

Field Type Stability Presence Description
commandId string Experimental required The idempotency handle (UUIDv7).
profileId string Experimental required The profile id to select — a stable native-catalog identifier (:auto-review, :ask-me, :read-only, :unrestricted, or an admitted user/managed definition).
sessionId string Experimental required The target session.
Source

schema/msp/experimental/msp.schema.json#/methods/session~2FsetPermissionProfile

{
"description": "Selects a preconfigured permission profile mid-session; select, never create.",
"params": {
"$ref": "#/$defs/SessionSetPermissionProfileParams"
},
"result": {
"$ref": "#/$defs/SessionSetPermissionProfileResult"
},
"x-msp-descriptor": "session/setPermissionProfile",
"x-msp-stability": "experimental"
}