---
title: "Read Effective Integration Policy"
method: GET
path: "/api/v1/integrations/policy/effective"
tags: ["Integrations"]
---

# Read Effective Integration Policy

`GET /api/v1/integrations/policy/effective`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `api/v1/login`
  - API key in query parameter `x-api-key`
  - API key in header `x-api-key`

Return the integration decision set that applies to this caller.

## Query parameters

- `flow_id` string, uuid, nullable
- `project_id` string, uuid, nullable

## Response `200`

Successful Response

- EffectiveIntegrationPolicyRead: The decision set a client must render, and where it came from.
  - `approved_provider_ids` string[], required: The loaded providers allowed for this caller; consult unrestricted to interpret an empty list.
  - `blocked_action_keys` string[], required: Operator-only deny-list; empty for non-superusers.
  - `loaded_provider_ids` string[], required: Loaded providers; restricted to allowed providers for non-superusers.
  - `managed_externally` boolean, required: True when a plugin owns the ceiling instead of the policy bundle.
  - `policy_revision` integer, nullable
  - `unrestricted` boolean, required: True when no ceiling is configured, i.e. every loaded provider is allowed.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `4349fbe90c64`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langflow-ai/apis/langflow/changes/api/v1/integrations/policy/effective/get.md)

---

[API](https://skmtc.dev/langflow-ai/apis/langflow.md) - [All operations](https://skmtc.dev/langflow-ai/apis/langflow/llms.txt) - [OpenAPI document](https://skmtc.dev/langflow-ai/apis/langflow/revisions/4349fbe90c64?raw)