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

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.

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

Path parameters

namestring required

Your name for this lock/bucket/sequence. Namespaced to your wallet; never persisted.

Query parameters

nsstring

Optional sub-namespace, for running two independent fleets from one wallet.

rateinteger

Tokens refilled per window.

perinteger

Window length in seconds.

burstinteger

Bucket capacity. Defaults to rate.

ninteger

Tokens to take.

Headers

Authorizationstring required

Bearer <session_token> from POST /v1/coord/session.

Response

Result.

object required

Changes

No recorded changes to this operation across all 1 revision of this API.