---
title: "Get PDP Health Status"
slug: "get-pdp-health-status"
updated: 2026-06-08T12:46:40Z
published: 2026-06-08T12:46:40Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Get PDP Health Status

Get/api/v1/abac/pdp/health![Defense](https://raw.githubusercontent.com/RocketChat/Rocket.Chat-Open-API/main/images/Defense.svg)

Checks the health and availability of the configured Policy Decision Point (PDP) for Attribute-Based Access Control (ABAC).

This endpoint is used by administrators to verify that the external PDP service is operational and properly configured. It includes rate limiting to prevent abuse.

Permissions required: `abac-management` and `manage-abac-admin-settings`.

### Changelog

| Version | Change |
| --- | --- |
| 8.0.0 | Added |
| 8.5.0 | Added the `manage-abac-admin-settings` granular permission requirement. |
| 8.4.0 | Added endpoint to check external PDP health status |

Header parametersX-Auth-TokenstringRequired

The `authToken` of the authenticated user.

ExampleRScctEHSmLGZGywfIhWyRpyofhKOiMoUIpimhvheU3f
X-User-IdstringRequired

The `userId` of the authenticated user.

ExamplerbAXPnMktTFbNpwtJ

Responses200

OK - PDP is available and healthy

<select class='api-response-data' aria-label='Media type'><option value='d4d8d0f3-9dcc-43de-9107-6270fdbf3be4'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='a0572314-d802-40a7-91f3-9c7158ceedc9'>PDP Healthy</option>
</select>PDP Healthy

```json
{
  "available": true,
  "message": "ABAC_PDP_Health_OK",
  "success": true
}
```

object  availableboolean    

Indicates whether the PDP is available.

Valid values[
  true
]
messagestring    

Health check message.

successboolean    

Indicates if the request was successful.

400

Bad Request - PDP is unavailable or unhealthy

<select class='api-response-data' aria-label='Media type'><option value='927c7374-525c-49b9-a6a4-adeaff6453cd'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='b44c1a54-994e-4d7f-9170-4a833a456d60'>PDP Unavailable</option>
<option value='d7034503-f930-480c-bc94-c1cb257b3c13'>Connection Error</option>
</select>PDP Unavailable

```json
{
  "available": false,
  "message": "ABAC_PDP_Health_Not_OK",
  "success": false
}
```

Connection Error

```json
{
  "available": false,
  "message": "Failed to connect to external PDP service",
  "success": false
}
```

object  availableboolean    

Indicates whether the PDP is available.

Valid values[
  false
]
messagestring    

Error message describing why the PDP is unavailable.

successboolean    

Indicates if the request was successful.

401

Unauthorized

<select class='api-response-data' aria-label='Media type'><option value='7cd21802-b579-4539-b126-50612b500885'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='765d425b-c97d-443c-ad78-7f01253172ef'>Authorization Error</option>
</select>Authorization Error

```json
{
  "status": "error",
  "message": "You must be logged in to do this."
}
```

object  statusstring    
messagestring    

403

Forbidden

<select class='api-response-data' aria-label='Media type'><option value='a9a8a760-9cd3-46af-962a-537e5a81279f'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='be98d2d0-3736-4105-beec-8c6735f96f7e'>Permission Error</option>
</select>Permission Error

```json
{
  "success": false,
  "error": "You do not have permission to manage ABAC"
}
```

object  successboolean    
errorstring