---
title: "Create or replace a schema annotation"
description: ""
canonical: "https://pgbeam.com/docs/api/schemaannotations/putSchemaAnnotation"
last-updated: "2026-09-09T11:37:53.000Z"
---

# Create or replace a schema annotation

> 

URL: https://pgbeam.com/docs/api/schemaannotations/putSchemaAnnotation

Attaches an operator-written description to a table (omit column_name) or a column. Keyed by (schema_name, table_name, column_name); an existing annotation with the same key is replaced.