---
title: "Authz policy OPA sync status"
method: GET
path: "/authz/policies/status"
tags: ["authz-policies"]
---

# Authz policy OPA sync status

`GET /authz/policies/status`

## Request

- Base URL: `https://developer.qaip.com/api/v1`
- URL: `https://developer.qaip.com/api/v1/authz/policies/status`
- Auth: API key in header `x-api-key`

(reserved for future use) Reports whether the active policies in the database are in sync with the OPA sidecar of the responding replica.

Required scope: \`policy:authz:manage\`

## Response `200`

Sync status

- AuthzPolicyStatus
  - `task_id` string, required: Identifier of the responding replica (per-replica view).
  - `all_in_sync` boolean, required
  - `policies` AuthzPolicyStatusEntry[], required
    - `name` string, required
    - `active_version` integer, required
    - `active_sha256` string, required
    - `opa_sha256` string, nullable
    - `in_sync` boolean, required

## Other responses

- `401`: Unauthorized - Authentication failed
- `403`: Forbidden - the API key is missing the scope required by this endpoint
- `502`: The application proxy could not obtain an upstream response before forwarding response headers. The error code is unavailable and retryable is false: upstream side effects may have completed, so a 502 alone does not make retrying safe. Check the operation's idempotency and recovery contract before retrying. A failure after streaming has started instead aborts the stream without appending this JSON body. CDN or load-balancer generated errors may have a different body and are not described by this response.
- `503`: Service Unavailable - authz/OPA is not configured in this environment

## Changes

- **2026-09-17** `2489c6f1a9d8`: 13 info
  - added the non-success response with the status `502`
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/code` to the response with the `503` status
  - …9 more
- **2026-06-17** `05add33422b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/qlonolink/apis/qaip-apis/changes/authz/policies/status/get.md)

---

[API](https://skmtc.dev/qlonolink/apis/qaip-apis.md) - [All operations](https://skmtc.dev/qlonolink/apis/qaip-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/qlonolink/apis/qaip-apis/revisions/2489c6f1a9d8?raw)