---
title: "Get active pipeline plan"
method: GET
path: "/v0/admin/plugins/plan"
tags: ["Admin"]
---

# Get active pipeline plan

`GET /v0/admin/plugins/plan`

## 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/plan`
- Auth: HTTP bearer

The active Pipeline Plan, an immutable mapping of every role of the deployment to the registration serving it, which api and worker follow. 404 not_found when no plan is active, because the startup configuration pins no plugin. Requires plugins:admin.

## 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 no active 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)