---
title: "Rename subscription"
method: POST
path: "/v0/subscriptions/{subscription_id}/rename"
tags: ["Subscriptions"]
---

# Rename subscription

`POST /v0/subscriptions/{subscription_id}/rename`

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

Change the display name of a Subscription. The name belongs to the Subscription, not to its immutable Versions, so no Version is created, evaluation and enabled state are unchanged, and its Matches and Deliveries stay attached. A new name commits subscription.renamed in every Corpus of the current Version; the same name commits nothing. Replay of the same key and request returns the Subscription; a changed request is 409 idempotency_conflict. A deleted Subscription is 409 subscription_deleted.

## Path parameters

- `subscription_id` string, required

## Request body

- RenameRequest: New display name of a Saved Query or Subscription.
  - `idempotency_key` string, required
  - `name` string, required

## Response `200`

Successful response

- Subscription: Absent owner means a global, organization-wide Subscription.
  - `subscription_id` string, required
  - `name` string, required
  - `enabled` boolean, required
  - `deleted` boolean, required: Logically deleted for good; a deleted Subscription is also disabled and stays readable with its Versions, Matches and Deliveries.
  - `current_version` SubscriptionVersion, required: Immutable Subscription configuration. Every Version keeps the Subscription's owner, absent for a global Subscription. destination_id is absent when this Version records Matches and change-feed notices without webhook delivery.
    - `subscription_id` string, required
    - `version_id` string, required
    - `saved_query_id` string, required
    - `saved_query_version_id` string, required
    - `evaluator` EvaluatorConfig, required: Pins an installed evaluator by plugin id and version, and its configuration. Evaluators are the subscription Contributions of the plugins pinned at startup (Plugin Protocol v0). The configuration must satisfy the evaluator's declared configuration schema.
      - `plugin_id` string, required
      - `version` string, required
      - `configuration` object, required
    - `destination_id` string
    - `owner` string: Subscription Owner, an opaque end-user reference defined by the client application (for example user-123). Quivr stores, filters and echoes it without interpreting it. At most 128 characters without control characters; none is reserved for the listing filter. A refused owner is 422 invalid_owner, in a creation body as in the listing filter.
  - `owner` string: Subscription Owner, an opaque end-user reference defined by the client application (for example user-123). Quivr stores, filters and echoes it without interpreting it. At most 128 characters without control characters; none is reserved for the listing filter. A refused owner is 422 invalid_owner, in a creation body as in the listing filter.

## Other responses

- `default`: Structured error. Existing /v0 authentication, scope, pagination and idempotency semantics apply.

---

[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)