> ## Documentation Index
> Fetch the complete documentation index at: https://portkey-docs-cursor-workspace-exclusions-guardrails-docs-7b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workspace Exclusions

> List workspaces excluded from organization-level input or output guardrails

List active workspace exclusions for **organization-level input or output guardrails**. Optionally filter by a single workspace.

Choose the path based on which exclusions you want to list:

| Entity            | Endpoint                                         |
| ----------------- | ------------------------------------------------ |
| Input guardrails  | `GET /v1/workspace-exclusions/input-guardrails`  |
| Output guardrails | `GET /v1/workspace-exclusions/output-guardrails` |

Query parameters and response shape are the same for both.

<Info>
  Requires an Admin API key (`organisation-service`) with the `organisation_exclusions.list` scope. Only Organization Owners and Admins can be granted this scope.
</Info>

## Query Parameters

<ParamField query="organisation_id" type="string" required>
  Organization UUID.
</ParamField>

<ParamField query="workspace_id" type="string">
  Optional workspace UUID or workspace slug. When provided, returns exclusions for that workspace only.
</ParamField>

## Example Request

### List input guardrail exclusions

```bash theme={"system"}
curl -X GET "https://api.portkey.ai/v1/workspace-exclusions/input-guardrails?organisation_id=6e44dcff-c77a-4325-a653-a77459f40aa6" \
  -H "x-portkey-api-key: $PORTKEY_ADMIN_API_KEY"
```

### List output guardrail exclusions for one workspace

```bash theme={"system"}
curl -X GET "https://api.portkey.ai/v1/workspace-exclusions/output-guardrails?organisation_id=6e44dcff-c77a-4325-a653-a77459f40aa6&workspace_id=ws-sandbox" \
  -H "x-portkey-api-key: $PORTKEY_ADMIN_API_KEY"
```

## Example Response

```json theme={"system"}
{
  "success": true,
  "data": {
    "exclusions": [
      {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "organisation_id": "6e44dcff-c77a-4325-a653-a77459f40aa6",
        "workspace_id": "11111111-2222-3333-4444-555555555555",
        "entity_type": "input_guardrails",
        "status": "active",
        "created_by": "user_or_key_id",
        "created_at": "2026-07-28T12:00:00.000Z",
        "last_updated_at": "2026-07-28T12:00:00.000Z"
      }
    ]
  }
}
```

`entity_type` is `input_guardrails` or `output_guardrails`, matching the endpoint you called.

## Related

* [Update Workspace Exclusions](/api-reference/admin-api/control-plane/workspace-exclusions/update-workspace-exclusions)
* [Enforcing Org Level Guardrails](/product/administration/enforce-orgnization-level-guardrails)
* [API Keys (AuthN and AuthZ)](/product/enterprise-offering/org-management/api-keys-authn-and-authz) — includes `organisation_exclusions.update` / `.list`