---
title: "Refresh taxonomy from connected CMS providers"
method: POST
path: "/v3/cms/taxonomy/refresh"
tags: ["CMS"]
---

# Refresh taxonomy from connected CMS providers

`POST /v3/cms/taxonomy/refresh`

Pulls the live categories/tags from the team's connected providers (WordPress, Ghost, Shopify, Webflow, Grigora) into the reusable vocabulary and returns it. Purely additive - terms created in SnowSEO are never removed. Re-importing each WordPress-published article's own assigned terms continues on the queue afterwards (`syncPending`). Single-flighted per team.

## Request body

- object
  - `teamId` string

## Response `200`

Default Response

- object
  - `syncedProviders` string[]
  - `categories` string[]
  - `tags` string[]
  - `syncPending` boolean

## Other responses

- `429` — Default Response
- `500` — Default Response

---

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