---
title: "Rename saved query"
method: POST
path: "/v0/saved-queries/{saved_query_id}/rename"
tags: ["Saved queries"]
---

# Rename saved query

`POST /v0/saved-queries/{saved_query_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/saved-queries/{saved_query_id}/rename`
- Auth: HTTP bearer

Change the display name of a Saved Query. The name belongs to the Saved Query, not to its immutable Versions, so no Version is created and no Subscription moves. A new name commits saved_query.renamed in every Corpus of the current Version; the same name commits nothing. Replay of the same key and request returns the Saved Query; a changed request is 409 idempotency_conflict. A deleted Saved Query is 409 saved_query_deleted.

## Path parameters

- `saved_query_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

- SavedQuery
  - `saved_query_id` string, required
  - `name` string, required
  - `deleted` boolean, required: Logically deleted; the Saved Query and its Versions stay readable.
  - `current_version` SavedQueryVersion, required
    - `saved_query_id` string, required
    - `version_id` string, required
    - `definition` SavedQueryDefinition, required: Immutable query definition. Expression semantics belong to the evaluator plugin; no core keyword or semantic threshold is implied. All Corpora belong to the authorized Organization.
      - `corpus_ids` string[], required
      - `expression` object, required
      - `retrieval_profile` string, required: A search profile the deployment answers (listSearchProfiles), recorded as sent; an unserved profile is 422 unsupported_profile. The profile is checked only when a definition is written, so a Version keeps its profile and keeps evaluating after the profile stops being served.
      - `temporal_policy` 'from_activation', required

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