---
title: "Update a knowledge base"
method: PATCH
path: "/v3/ai-sdr/knowledge-bases/{id}"
tags: ["AI SDR Knowledge Bases"]
---

# Update a knowledge base

`PATCH /v3/ai-sdr/knowledge-bases/{id}`

<small>_Requires the `ai-sdr:write` scope (or a broader one that includes it)._</small>

Partial update — send only the fields you want to change. At least one field must be present.

Requires the AI SDR feature on the caller's team.

## Path parameters

- `id` integer, required

## Request body

- object — Partial update for a knowledge base. Send only the fields you want to change; absent fields retain their current value. At least one field must be present.
  - `name` string — Updated display name (non-empty)
  - `instructions` string — Updated instructions. Empty string allowed (clears the instructions).

## Response `200`

Knowledge base updated successfully

- object — Detailed representation of a knowledge base.
  - `id` integer — Unique identifier for the knowledge base
  - `name` string — Display name of the knowledge base
  - `instructions` string — Free-form instructions applied when the knowledge base is referenced by AI SDR generations.
  - `updatedAt` string, date-time — Timestamp of the last modification
  - `ownerUserId` integer, nullable — User ID of the owner. `null` when the owner has been removed from the team.

## Other responses

- `400` — Validation failure on the request body
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `403` — AI SDR feature is not available for the caller's team
- `404` — Knowledge base not found
- `502` — Upstream AI SDR service failure

---

[API](https://skmtc.net/reply/apis/reply-api.md) · [All operations](https://skmtc.net/reply/apis/reply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reply/reply-api/revisions/1c3d32eaf95e/schema)