---
title: "Trigger an on-demand rank refresh"
method: POST
path: "/projects/{projectId}/refresh"
tags: ["Rank tracking"]
---

# Trigger an on-demand rank refresh

`POST /projects/{projectId}/refresh`

## Path parameters

- `projectId` string, required — Project id (from GET /projects)

## Request body

- object
  - `keyword_ids` string[]

## Response `202`

Success

- object

## Other responses

- `401` — Missing or invalid API key
- `403` — Insufficient project permission or subscription required
- `404` — Not found (or no data available yet)
- `422` — Request validation failed (details lists the fields)
- `429` — Rate limit exceeded — respect Retry-After

---

[API](https://skmtc.dev/zutrix/apis/zutrix-api.md) · [All operations](https://skmtc.dev/zutrix/apis/zutrix-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zutrix/zutrix-api/revisions/abe6ff22567c/schema)