---
title: "Update Label Endpoint"
method: PATCH
path: "/admin/email-classifier/labels/{gmail_message_id}"
tags: ["admin-email-classifier"]
---

# Update Label Endpoint

`PATCH /admin/email-classifier/labels/{gmail_message_id}`

Partial update of a labeled email's label and/or reviewer notes.
Only fields explicitly present in the request body are touched.
403 if the email is not from the caller's inbox.

## Path parameters

- `gmail_message_id` string, required

## Request body

- LabelPatchRequest — Partial update. Fields left unset are not touched. Sending `notes` as an empty string or `null` clears the reviewer note.
  - `label` boolean, nullable
  - `notes` string, nullable

## Response `200`

Successful Response

- LabelPatchResponse
  - `gmail_message_id` string, required
  - `label` boolean, required
  - `original_label` boolean, nullable, required
  - `reviewed_at` string, date-time, nullable, required
  - `reviewer_notes` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)