List role ownerships before deletion

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/iam/roles/{role_id}/delete-ownerships

Before you call this API

Prepare a canonical role ID and workspace credentials. Regular deletion checks require role.delete; transfer_requested=true additionally requires role.manage_policy. Read total deletion impact and blocking reasons from existing delete-impact; this API reads one object page only.

Request

curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/roles/$ROLE_ID/delete-ownerships" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "limit=1" \
  --data-urlencode "transfer_requested=false"
curl -X GET "https://api.moi.matrixorigin.cn/v5/workspaces/$WORKSPACE_ID/iam/roles/$ROLE_ID/delete-ownerships" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  --get \
  --data-urlencode "limit=1" \
  --data-urlencode "transfer_requested=false" \
  --data-urlencode "cursor=$NEXT_CURSOR"

When a next cursor exists:

Field

Type

Description

limit

integer

Defaults to 10, range 1–100. Explicit empty input is invalid.

cursor

string

Previous next_cursor; do not reuse across workspaces/source roles.

transfer_requested

boolean

true/false only; defaults to false. Empty is invalid.

Result

{
  "code": "OK",
  "msg": "OK",
  "data": {
    "items": [
      {
        "resource_type": "connector",
        "resource_id": "connector-example",
        "display_name": "Orders",
        "ownership_version": 3
      }
    ],
    "ownership_version": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "next_cursor": "eyJXb3Jrc3BhY2VJRCI6IndvcmtzcGFjZS1leGFtcGxlIiwiUm9sZUlEIjoiOCIsIlZlcnNpb24iOiJhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhYWFhIiwiUmVzb3VyY2VUeXBlIjoiY29ubmVjdG9yIiwiUmVzb3VyY2VJRCI6ImNvbm5lY3Rvci1leGFtcGxlIn0"
  }
}

items[].ownership_version is per-object integer CAS. Outer ownership_version is a deletion-set version string. They are not interchangeable. Continue only with nonempty next_cursor. Later pages retain the first set version but read current data, not a locked immutable snapshot. Refresh after changes; final deletion revalidates the complete plan.

The standalone list has no owned_count or full total. Use canonical resource IDs when display names are absent; name enrichment may be empty for some types. Workflow names come from the same workspace system database; failures do not return partial pages. Reading transfers/deletes no objects or roles.

Last updated on