---
title: "Your effective limits, each with the deciding layer"
method: GET
path: "/preview/limits"
tags: ["limits"]
---

# Your effective limits, each with the deciding layer

`GET /preview/limits`

## Request

- Base URL: `https://autoresearch.sfcompute.com`
- URL: `https://autoresearch.sfcompute.com/preview/limits`
- Auth: HTTP bearer

Your effective limits, every knob in one read - the numbers the teaching errors quote, available before the wall instead of at it. Each row carries the effective value for you in this org, the layer that decided it ("default", or an "org override"/"customer override" set by support - overrides can lower a limit as well as raise it), whether support can set it per-org today (settable: true), who can raise it (settable_by: "self_serve" = an org admin, at once, up to raisable_to; "support" = request_limit_increase files the ask and an operator decides; "platform" = deploy configuration), and one line on what it bounds. A row's hard_max, when present, is the platform hard cap no override can exceed (fleet hardware, not policy). A row's raisable_to, when present, is the most an org admin gets at once with request_limit_increase. Without it, or above it, that tool files a request and an operator decides. Rows with layer "platform" are platform-set job, build, and checkpoint knobs: deploy configuration, not per-org levers today.

## Query parameters

- `workspace` string

## Request body

- object
  - `org` string, nullable: Organization: an org uuid or an org name from list_team's memberships; omitted = your active org.

## Response `200`

The capability's JSON result.

- Result: The capability's result: the same object the MCP tool returns as structuredContent. Resources carry an `object` type discriminator and an immutable id; money is integer micro-dollars in `*_usd_micros` fields.
  - `object` string: The resource type, when the result is one resource.

## Other responses

- `400`: Malformed request: bad JSON, a parameter that does not parse, or a value outside its range. Code `invalid`.
- `401`: No bearer token, or one this API cannot verify. Code `unauthenticated`.
- `403`: Authenticated, but the token's scopes or the account's role do not reach this operation. The message names the scope word to request. Code `forbidden`.
- `404`: No such route. Code `not_found`; the body names the OpenAPI document.
- `422`: A well-formed request the platform declined: no such node, a cap reached, a state that forbids the move. The message says which, and what to do instead. Code `refused`.
- `429`: Over this door's per-customer budget. Wait `Retry-After` seconds. Code `rate_limited`.
- `500`: Our fault. Retry; if it persists, quote the request-id. Code `internal`.

---

[API](https://skmtc.dev/givemeanode/apis/autoresearch-customer-api.md) · [All operations](https://skmtc.dev/givemeanode/apis/autoresearch-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/givemeanode/apis/autoresearch-customer-api/revisions/f88dcb70ac6c?raw)