Show rate limits

The rate limits of this access, and how much of each is left.

RReadIdempotent
Tool
manitu_access_rate_limit_geton https://mcp.manitu.de/mcp
POST
/v1/access/rate-limit/geton https://api.manitu.de
Try it
readOnlyHint truedestructiveHint falseidempotentHint trueopenWorldHint false

Returns the rate limits of this access - how many calls it may make in which time, and how many of each are left until when. Changes nothing, and counts as a call itself. Call it when a call was refused with RATE_LIMITED, or before many calls in a row, to pace them instead of being refused.

Takes no arguments.

limit_listarray of object

Every rate limit of this access. A call is refused when one limit that counts it has nothing left.

limit_list[].namestring

The limit, as RateLimit-Policy names it.

limit_list[].limitinteger

Calls per window: the pace at which the limit refills, one call every window_seconds / limit seconds.

limit_list[].window_secondsinteger

The window the pace is given in.

limit_list[].burstinteger

Calls that may come at once when the limit is whole.

limit_list[].remaininginteger

Calls that may come at once now.

limit_list[].reset_secondsinteger

Seconds until the limit is whole again; 0 when it is.

limit_list[].perstring

Whom the limit counts: this credential, the calling address, everybody together, or everybody who shares the attribute in per_attribute.

One of credential ip all attribute
limit_list[].per_attributestring | null

The attribute, where per is "attribute" - an account, say.

limit_list[].applies_toobject

Which calls the limit counts; null in a field means every one.

limit_list[].applies_to.facadearray of string | null
limit_list[].applies_to.access_kindarray of string | null
limit_list[].applies_to.operationarray of string | null
limit_list[].applies_to.side_effectarray of string | null

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

No fields - send {} or no body.

limit_listarray of object

Every rate limit of this access. A call is refused when one limit that counts it has nothing left.

limit_list[].namestring

The limit, as RateLimit-Policy names it.

limit_list[].limitinteger

Calls per window: the pace at which the limit refills, one call every window_seconds / limit seconds.

limit_list[].window_secondsinteger

The window the pace is given in.

limit_list[].burstinteger

Calls that may come at once when the limit is whole.

limit_list[].remaininginteger

Calls that may come at once now.

limit_list[].reset_secondsinteger

Seconds until the limit is whole again; 0 when it is.

limit_list[].perstring

Whom the limit counts: this credential, the calling address, everybody together, or everybody who shares the attribute in per_attribute.

One of credential ip all attribute
limit_list[].per_attributestring | null

The attribute, where per is "attribute" - an account, say.

limit_list[].applies_toobject

Which calls the limit counts; null in a field means every one.

limit_list[].applies_to.facadearray of string | null
limit_list[].applies_to.access_kindarray of string | null
limit_list[].applies_to.operationarray of string | null
limit_list[].applies_to.side_effectarray of string | null
200Success.400The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.401No credential was presented, or it was not recognised (UNAUTHENTICATED).403The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.429Too many calls. The Retry-After header says when to try again.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.
Example