---
title: "Get pipeline plan"
method: GET
path: "/v0/admin/plugins/plans/{plan_id}"
tags: ["Admin"]
---

# Get pipeline plan

`GET /v0/admin/plugins/plans/{plan_id}`

## 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/{plan_id}`
- Auth: HTTP bearer

Any Pipeline Plan this deployment recorded, active or not. Plans are immutable, so an earlier plan stays readable after an activation. Requires plugins:admin.

## Path parameters

- `plan_id` string, required

## Response `200`

Successful response

- PipelinePlan
  - `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, 404 unknown plan, 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)
