---
title: "Consume from a rate limit shared across the fleet (1 operation)"
method: POST
path: "/v1/coord/quota/{name}"
---

# Consume from a rate limit shared across the fleet (1 operation)

`POST /v1/coord/quota/{name}`

## Request

- Base URL: `https://soren.com`
- URL: `https://soren.com/v1/coord/quota/{name}`
- Auth: none declared. Required headers: `Authorization`

A token bucket every agent in your fleet draws from, so nine agents can share one upstream API quota. Returns granted with the remainder, or retry_after_ms.

## Path parameters

- `name` string, required

## Query parameters

- `ns` string
- `rate` integer
- `per` integer
- `burst` integer
- `n` integer

## Headers

- `Authorization` string, required

## Response `200`

Result.

- object

## Other responses

- `401`: No valid session token.
- `402`: Payment required, or the session budget is exhausted.

---

[API](https://skmtc.dev/soren/apis/soren-free-games-api.md) · [All operations](https://skmtc.dev/soren/apis/soren-free-games-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soren/apis/soren-free-games-api/revisions/00402cfcf30d?raw)