---
title: "List Policies"
method: GET
path: "/api/mesh/policies/{team_key}"
tags: ["mesh"]
---

# List Policies

`GET /api/mesh/policies/{team_key}`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/mesh/policies/{team_key}`
- Auth: HTTP bearer

## Path parameters

- `team_key` string, required

## Query parameters

- `page` integer
- `page_size` integer
- `show_inactive` boolean
- `search` string
- `override_state` PolicyOverrideState[]
- `decision` PolicyDecision[]
- `policy_type` PolicyType[]
- `operating_system` string[]
- `group` union
  - 'powershell_helpers_formatting' | 'networking_connectivity' | 'security_device_trust' | 'locale_time_power' | 'system_hardware' | 'processes_services_event_logs' | 'files_registry' | 'identity_sessions_policy' | 'printing' | 'storage' | 'software_updates' | 'scheduled_tasks'
  - 'unclassified'

## Response `200`

Successful Response

- PolicyListResponse: Paginated policy list.
  - `results` PolicyDetail[], required
    - `group` 'powershell_helpers_formatting' | 'networking_connectivity' | 'security_device_trust' | 'locale_time_power' | 'system_hardware' | 'processes_services_event_logs' | 'files_registry' | 'identity_sessions_policy' | 'printing' | 'storage' | 'software_updates' | 'scheduled_tasks', nullable
    - `key` string, required
    - `policyType` 'cmdlet' | 'pattern', required
    - `source` 'global' | 'team', required
    - `decision` 'allow' | 'deny' | 'needs_approval', required
    - `isActive` boolean, required
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `cmdletName` string, nullable
    - `module` string, nullable
    - `verb` string, nullable
    - `noun` string, nullable
    - `operatingSystem` string, nullable
    - `pattern` string, nullable
    - `priority` integer, nullable
    - `description` string, nullable
    - `notes` string, nullable
    - `securityNotes` string, nullable
    - `isSystemLocked` boolean, nullable
    - `override` PolicyOverrideRef: Reference to the global rule a team rule shadows.
      - `source` 'global'
      - `decision` 'allow' | 'deny' | 'needs_approval', required
      - `isSystemLocked` boolean, required
    - `loosens` string, nullable
    - `loosenedBy` integer, nullable
  - `count` integer, required
  - `page` integer, required
  - `pageSize` integer, required
  - `totalPages` integer, required
  - `counts` PolicyOverrideStateCounts: Counts per override state for chip badges.
    - `total` integer
    - `lockedGlobal` integer
    - `overridableGlobal` integer
    - `teamOverride` integer
    - `teamOnly` integer

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)