Quota

Generated from capsule-server/openapi.json, the OpenAPI 3.2 document capsule-server emits and mise run openapi-check-kynos keeps current. To change a description on this page, change the annotation on the handler or model it comes from and regenerate — this file is build output. The auth model, error contract, and conventions common to every endpoint are on the REST API overview.

GET /v1/quota

Report the authenticated uploader’s storage-quota snapshot.

Scoped to the caller, and to nobody else: quota is accounted to the uploader, and one account’s storage use is not another’s business.

Authentication: required — bearer.

Status	Body	Description
200	QuotaResponse application/json	OK.
401	CodedProblem application/problem+json	Unauthorized. Headers: WWW-Authenticate.
403	CodedProblem application/problem+json	Forbidden.
413	—	the request body exceeds the configured limit.
500	CodedProblem application/problem+json	Internal server error.

Schemas

The models these endpoints carry. A field whose type names another model links to it when this page documents that model, which it does when some path from an operation reaches it within 4 references. A model only ever reached deeper than that is named without being expanded.

CodedProblem

An RFC 9457 problem detail.

Field	Type	Description
type	string	Required.
title	string	—
status	integer	Required.
detail	string	—
instance	string	—
code	string	Required. The stable error.* catalog code. The client localizes this; detail stays English. Present on every problem this server renders.

QuotaResponse

A user’s quota snapshot.

Field	Type	Description
used	integer	Required. Bytes charged to the caller.
soft_limit	integer | null	Where the warning starts, or absent on an unlimited deployment.
hard_limit	integer | null	Where uploads stop, or absent on an unlimited deployment.
state	string	Required. The classified state: ok, soft_warning, hard_exceeded, grace_expired.