---
title: "Shared sliding-window rate counters (\"6/6h\"): take, peek, list."
method: POST
path: "/api/v1/rate"
tags: ["coordination"]
---

# Shared sliding-window rate counters ("6/6h"): take, peek, list.

`POST /api/v1/rate`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/rate`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'take' | 'peek' | 'list', required
  - `name` string
  - `limit` string
  - `n` integer

## Response `200`

allowed, remaining, retry_after_s

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)