---
title: "POST /practice-simulation-suggestions/refresh"
method: POST
path: "/practice-simulation-suggestions/refresh"
tags: ["Practice simulations"]
---

# POST /practice-simulation-suggestions/refresh

`POST /practice-simulation-suggestions/refresh`

## Request

- Base URL: `https://api.rulebase.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rulebase.co/practice-simulation-suggestions/refresh`
- Auth: none declared

Regenerates the caller's organization's suggestions now and explains why criteria were skipped. Once per 10 minutes per organization.

## Response `200`

Refresh result and diagnostics

- object
  - `data` PracticeSimulationSuggestionRefresh, required
    - `generated` integer, required
    - `considered_criteria` integer, required
    - `skipped` object, required
    - `top_rejections` object[], required
      - `criterion` string, required
      - `rule` string, required
      - `detail` string, required

## Other responses

- `400`: Invalid request
- `403`: Forbidden
- `404`: Not found
- `409`: Not allowed in the current state
- `429`: Refreshed less than 10 minutes ago (code refresh_too_soon)
- `502`: The practice world failed
- `503`: Practice simulations are unavailable

## Changes

- **2026-10-19** `efddfbe7c7bc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rulebase/apis/rulebase-api2/changes/practice-simulation-suggestions/refresh/post.md)

---

[API](https://skmtc.dev/rulebase/apis/rulebase-api2.md) · [All operations](https://skmtc.dev/rulebase/apis/rulebase-api2/llms.txt) · [OpenAPI document](https://skmtc.dev/rulebase/apis/rulebase-api2/revisions/eb27ab823c55?raw)