Update role lifecycle¶

Enable or disable a specified role. Changing the role state affects later role assignment and authorization management.

PUT https://moi.matrixorigin.cn/newmoi/workspaces/{workspace_id}/iam/roles/{role_id}/lifecycle

Preparation before calling¶

First select the role, confirm that its state can be changed, and prepare the change using the current state in the list. Prepare a personal access token with the required permission in the target workspace and the target workspace ID.

Request parameters¶

Input example

curl -X PUT "https://moi.matrixorigin.cn/newmoi/workspaces/$WORKSPACE_ID/iam/roles/$ROLE_ID/lifecycle" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"req-001","target_state":"disabled","reason_code":"temporary_suspension","expected_lifecycle_version":1}'

Parameter description

Path parameters

Parameter	Type	Required	Description
workspace_id	string	Yes	Target workspace ID.
role_id	string	Yes	Target role ID.

Request body

Parameter	Type	Required	Description
request_id	string	Yes	Request ID.
target_state	string	Yes	Target state. Must be `active` or `disabled`.
reason_code	string	Yes	Change reason code.
expected_lifecycle_version	integer	Yes	Expected role lifecycle version. Must be greater than `0`.

Successful response¶

On success, returns the changed role state and new lifecycle version. Replaying the same request ID with the same content does not apply the state change again.

Response example

{"code":"OK","msg":"OK","data":{"role":{"workspace_id":"workspace-001","role_id":"role-001","role_name":"analyst","description":"Data analysis role","lifecycle_state":"disabled","lifecycle_version":4,"system_role":false},"idempotent_replay":false}}

Field details

Field	Type	Description
code	string	`OK` on success.
msg	string	`OK` on success.
data.role	object	Role summary after the state change.
data.role.lifecycle_state	string	Current lifecycle state.
data.role.lifecycle_version	integer	Updated lifecycle version.
data.idempotent_replay	boolean	Whether this is an idempotent replay of the same request.

Error response¶

Response example

{"code":"ErrParamInvalid","msg":"请求参数无效","data":null}

Field details

Field	Type	Description
code	string	Error code.
msg	string	Error message.
data	null	—

Last updated on Sep 3, 2026