# Revoke on object (legacy)

Revoke a privilege using an object type and object name.

SDK: `@zilliz/milvus2-sdk-node@3.0.10` · Tested with Milvus 3.0.6

Canonical documentation: https://milvus-io.github.io/milvus-sdk-node/rest-api/roles/revoke-privilege/

## Section links

- [cURL command](https://milvus-io.github.io/milvus-sdk-node/rest-api/roles/revoke-privilege/#curl-command)
- [Default request](https://milvus-io.github.io/milvus-sdk-node/rest-api/roles/revoke-privilege/#default-request)
- [Sample response](https://milvus-io.github.io/milvus-sdk-node/rest-api/roles/revoke-privilege/#sample-response)
- [Request fields](https://milvus-io.github.io/milvus-sdk-node/rest-api/roles/revoke-privilege/#request-fields)

`POST /v2/vectordb/roles/revoke_privilege`

Replace `https://your-cluster.example.com` with your Milvus endpoint. Set `MILVUS_TOKEN` for authentication or omit the Authorization header on an unauthenticated cluster.

## cURL command

```bash
curl --request POST --url 'https://your-cluster.example.com/v2/vectordb/roles/revoke_privilege' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer ${MILVUS_TOKEN}" \
  --data-raw '{
  "dbName": "default",
  "roleName": "catalog_reader",
  "objectType": "Collection",
  "objectName": "books",
  "privilege": "Search"
}'
```

## Default request

```json
{
  "dbName": "default",
  "roleName": "catalog_reader",
  "objectType": "Collection",
  "objectName": "books",
  "privilege": "Search"
}
```

## Sample response

```json
{
  "code": 0,
  "data": {}
}
```

## Request fields

- `roleName` string (required)
  Milvus role name.
- `objectType` string (required)
  Object type to which the grant applies, such as Collection.
- `objectName` string (required)
  Object name within the grant scope.
- `privilege` string (required)
  Name of the privilege to grant or revoke.
- `dbName` string
  Database name. Operations on collections use default when omitted.

See [`HttpClient.revokePrivilegeFromRole`](https://milvus-io.github.io/milvus-sdk-node/api-reference/http-client/#revokeprivilegefromrole) for the Node.js SDK method.
