Get workspace member details¶
POST /user/detail_info reads profile, role/tag, and operation projections for a joined workspace member. This independent detail operation is not replaced by member or current-role lists.
Before you call this API¶
Set MOI_ENDPOINT to the product API prefix https://api.moi.matrixorigin.cn/v5. For private deployments, use the corresponding product API URL.
Use a product identity with workspace access and X-Workspace-ID. Obtain member id or iam_user_id from the joined-member list, not invitation IDs or UC subjects. The specification requires workspace_member.read; the composition layer explicitly authorizes workspace_member.get and separately projects allowed_actions.
Request¶
curl -X POST "$MOI_ENDPOINT/user/detail_info" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $WORKSPACE_ID" \
-H 'Content-Type: application/json' \
-d "{\"id\":\"$MEMBER_ID\"}"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
X-Workspace-ID |
header string |
Yes |
Target workspace |
id |
body string or number |
Yes |
Member reference. Prefer strings to preserve identifiers. Supports IAM user references or mappable product principal references |
The handler consumes id only, without strict rejection of unknown fields or a second JSON object. Do not import other APIs’ strict JSON guarantees. Empty IDs and unbindable types are rejected. Numeric binding does not mean arbitrary numbers resolve to valid members.
Successful response¶
{
"code": "OK",
"msg": "OK",
"data": {
"allowed_actions": [
"workspace_member.update"
],
"id": "principal-example",
"iam_user_id": "456",
"name": "Example",
"status": "enabled",
"created_at": "2026-11-12T00:00:00Z",
"updated_at": "2026-11-12T00:00:00Z",
"reserved": false,
"role_list": [
{
"id": 123,
"name": "Data analyst",
"status": "enabled"
}
],
"tag_list": []
}
}
Field |
Type |
Description |
|---|---|---|
data.id |
string |
Product principal identifier from profile mapping, separate from iam_user_id |
data.iam_user_id |
string |
IAM user identifier of the current member |
data.name |
string |
Display name derived from alias, product display name, email, or IAM reference |
data.description |
string |
Description when present. Reserved-member descriptions may be localized |
data.status |
string |
Current active/disabled member facts projected to enabled/disabled |
data.created_at / updated_at |
string |
UTC RFC3339 timestamps |
data.reserved |
boolean |
Reserved/protected-member flag, not permission for arbitrary operations |
data.role_list |
array (array of objects) |
Member roles. Each item has integer id and string name/status |
data.tag_list |
array (array of objects) |
Member tags. Each item has integer id and string value |
data.allowed_actions |
string[] (array of strings) |
Core projection calculated separately for the current workspace/effective role. Still an array when empty |
Empty roles/tags are[]. allowed_actions projects current workspace operations and does not replace target protection, lifecycle/CAS, or write-time checks. Do not grant access from role names/reserved alone. SDK github_login/deletion fields do not prove these details return them. Regular details do not populate deletion; incomplete-deletion information belongs to member-list projections.
Errors and read scope¶
HTTP |
code |
Current branch |
|---|---|---|
400 |
INVALID_ARGUMENT |
Workspace header or id binding failed |
404 |
USER_NOT_FOUND |
Reference unmapped, no membership fact, or lifecycle outside current detail-read scope |
403 |
IAM_ERROR_CODE_PERMISSION_DENIED |
Core authorization denied |
503 |
IAM_ERROR_CODE_CORE_AUTHORIZE_UNAVAILABLE |
Authorization dependency unavailable |
500 |
INTERNAL |
Other profile/storage/projection failure |
Member errors use code/msg/data:null; msg is HTTP status text. Invited or incomplete-deletion member-list entries need not be readable through details. DAO details select active/disabled only. Mapping fallback occurs only after original NotFound; storage errors do not fall back to another identity.