---
title: "POST /v1/iam/permissions/scan"
method: POST
path: "/v1/iam/permissions/scan"
tags: ["IAMService"]
---

# POST /v1/iam/permissions/scan

`POST /v1/iam/permissions/scan`

ScanPermissions 按代码内置权限目录扫描同步权限表：补插缺失的内置权限、
 更新内置权限元数据、删除代码中已不存在的内置权限（连同角色绑定；被菜单
 引用的跳过删除）。用户自建（isBuiltin=false）权限不受影响。幂等。

## Request body

- IamV1ScanPermissionsRequest

## Response `200`

OK

- IamV1ScanPermissionsReply
  - `created` string[] — 本次补插的权限 code 列表。
  - `deleted` string[] — 本次删除的失效内置权限 code 列表。
  - `skippedMenuRefs` string[] — 因被菜单 perm_code 引用而跳过删除的权限 code 列表。
  - `updated` string[] — 本次更新元数据的权限 code 列表。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)