# 查询当前调用身份的能力

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

```text
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/iam/me/capabilities
```

## 调用前准备

准备工作区凭据与当前角色上下文；可复用已配置的 SDK/CLI 工作区角色映射。此接口返回当前调用身份的能力，不查询任意目标角色。

## 请求

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/me/capabilities" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "capability_id=action.role.create" \
  --data-urlencode "capability_id=navigation.roles"
```

```bash
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/me/capabilities" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"
```

:::::
:::::{tab-item} 参数说明

省略筛选读取现有完整清单：



| 字段 | 类型 | 说明 |
| --- | --- | --- |
| capability_id | 重复的 string 查询项 | 省略表示全量；按 ID 选择时每项独立传递，不用逗号拼接。 |

:::::
::::::
:::::::

## 返回结果

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "effective_role_id": "7",
    "capability_version": "definition-example",
    "request_id": "request-example",
    "trace_id": "trace-example",
    "items": [
      {
        "capability_id": "action.role.create",
        "action_id": "role.create",
        "resource_type": "workspace",
        "reason_code": "",
        "allowed": true,
        "all_resources": true,
        "resource_ids": []
      },
      {
        "capability_id": "navigation.roles",
        "action_id": "role.read",
        "resource_type": "workspace",
        "reason_code": "",
        "allowed": true,
        "all_resources": true,
        "resource_ids": []
      }
    ],
    "unsupported_capability_ids": []
  }
}
```

:::::
:::::{tab-item} 字段说明

支持项及不支持项分别去重并按 ID 排序；未知 ID（包括空字符串）原样进入 unsupported_capability_ids，不使整个请求失败，也不自动 trim 或拆分。全部不支持仍为 200 和空 items，但仍执行当前身份/角色及成员有效性验证。查询编码损坏为 400 INVALID_ARGUMENT。

allowed=false 是明确返回的拒绝，不是不支持或查询失败。对象操作还需按 all_resources/resource_ids 判断范围；未请求项不能当无权限，旧版本/切换角色前的结果也不能作为当前授权。该结果不替代写操作实时鉴权。独立接口保留 action/resource/version 元数据，与 user/info 的精简 bootstrap 形状不同。

:::::
::::::
:::::::
