---
title: "Update Gmail labels for store ingestion"
method: PUT
path: "/v1/integrations/gmail/labels"
tags: ["integrations"]
---

# Update Gmail labels for store ingestion

`PUT /v1/integrations/gmail/labels`

Update Gmail labels and optional Gmail search query selected for ingestion into a store.

## Request body

- GmailLabelSelectionUpdateParams — Operation for updating Gmail label ingestion selection.
  - `installation_id` string, uuid, required — Gmail installation ID
  - `label_ids` string[] — Complete set of Gmail label IDs to sync

## Response `200`

Updated Gmail label selection

- GmailLabelSelectionUpdateResponse — Gmail label selection update response.
  - `data` GmailLabelSelectionUpdate, required — Result of updating Gmail label selection.
    - `store_id` string, required — Mixedbread store ID
    - `selected_label_ids` string[], required — Selected Gmail label IDs
    - `backfill_label_ids` string[], required — Labels newly selected and ready for backfill
    - `skipped_labels` object, required — Label IDs skipped with a reason

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/versions/2eece97b5ae5/schema)