---
title: "List Launch policies"
method: GET
path: "/workspaces/{workspace}/admin/policies"
tags: ["LaunchPolicy"]
---

# List Launch policies

`GET /workspaces/{workspace}/admin/policies`

## Request

- Base URL: `https://plainrouter.com/api/v1`
- URL: `https://plainrouter.com/api/v1/workspaces/{workspace}/admin/policies`
- Auth: HTTP bearer

Read or maintain versioned naming and UTM policies in the authorized workspace. Policies apply to plans without submitting provider writes.

## Path parameters

- `workspace` integer, required

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

- object
  - `policies` object, required
    - `current_page` integer, required
    - `data` LaunchPolicy[], required
      - `id` string, required
      - `workspace_id` integer, required
      - `kind` string, required
      - `name` string, required
      - `version` integer, required
      - `body` unknown[], required
        - unknown
      - `status` string, required
      - `created_at` string, date-time, nullable, required
      - `updated_at` string, date-time, nullable, required
    - `first_page_url` string, nullable, required
    - `from` integer, nullable, required
    - `last_page_url` string, nullable, required
    - `last_page` integer, required
    - `links` object[], required: Generated paginator links.
      - `url` string, nullable, required
      - `label` string, required
      - `active` boolean, required
    - `next_page_url` string, nullable, required
    - `path` string, nullable, required: Base path for paginator generated URLs.
    - `per_page` integer, required: Number of items shown per page.
    - `prev_page_url` string, nullable, required
    - `to` integer, nullable, required: Number of the last item in the slice.
    - `total` integer, required: Total number of items being paginated.

## Other responses

- `401`: Invalid or missing Server secret.
- `404`: A missing workspace returns the api_route_not_found envelope.
- `422`: JSON booleans in integer inputs, including workspace selectors, return message plus errors mapping field names to arrays of messages. Numeric strings retain their existing validation and coercion.

---

[API](https://skmtc.dev/plainrouter/apis/plainrouter-conversion-api.md) · [All operations](https://skmtc.dev/plainrouter/apis/plainrouter-conversion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/plainrouter/apis/plainrouter-conversion-api/revisions/d071d4f4f05c?raw)