---
title: "List pipeline plans"
method: GET
path: "/v0/admin/plugins/plans"
tags: ["Admin"]
---

# List pipeline plans

`GET /v0/admin/plugins/plans`

## Request

- Base URL: `https://docs.quivr.thevibecompany.co` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.quivr.thevibecompany.co/v0/admin/plugins/plans`
- Auth: HTTP bearer

The latest Pipeline Plans this deployment recorded, newest first. Each names the plan it replaced (previous_plan_id) and what recorded it (source), so this list is the history of plan changes; earlier plans stay reachable through previous_plan_id. Requires plugins:admin.

## Query parameters

- `limit` integer

## Response `200`

Successful response

- PipelinePlanList
  - `items` PipelinePlan[], required
    - `plan_id` string, required
    - `created_at` string, date-time, required
    - `activated_at` string, date-time, required
    - `source` 'configuration' | 'activation' | 'rollback', required: What recorded the plan, and so why the plan changed. configuration is the startup configuration, which applies the roles its pins changed since it last applied, even over an earlier activation of the same role. activation is an operator activation. rollback is an operator rollback to an earlier plan's roles.
    - `previous_plan_id` string: The plan this one replaced; absent for the first plan of the deployment.
    - `roles` PipelinePlanRole[], required: One entry per role, sorted by role.
      - `role` string, required
      - `registration_id` string, required
      - `plugin_id` string, required
      - `version` string, required

## Other responses

- `default`: Structured error; 401 unauthenticated, 403 without plugins:admin, 422 invalid_limit, 503 storage unavailable.

---

[API](https://skmtc.dev/thevibecompany/apis/quivr-http-api.md) - [All operations](https://skmtc.dev/thevibecompany/apis/quivr-http-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thevibecompany/apis/quivr-http-api/revisions/4f4e30ba8f4e?raw)