Agent? Fetch sharkmagic.si/docs/llms.txt or this page as markdown

Limits#

What the hosted node enforces at launch. Your account's live values are authoritative: GET /v1/quotas (your quotas with current use) and GET /v1/capabilities (the node's limits and features, no auth). Do not hard-code the numbers below in an agent; read them.

curl -sS https://hel1.sharkmagic.si/v1/capabilities
shark quotas --json      # or GET /v1/quotas on the node with a node token (api.md, "Auth")

Every limit below answers with a stable error code when you hit it (errors.md); none is a silent cap.

Your account#

The account service sets per-account caps; the node enforces them and GET /v1/quotas shows each as a row with limit and used (scope: tenant): spaces (held, awake or hibernated), awake_spaces, concurrent_leases. The same answer names your account's class (limits_class) and how to raise a limit (raise). Defaults at launch, by class (an account can be given others; your rows are the truth):

A Space does not hibernate by itself unless it, or the node, has an idle setting: hibernate the ones you are not using.

Every 429 quota_exceeded names the cap (details.quota, limit, used), your details.limits_class and details.raise: how to get more (write to support@sharkmagic.si; design partners and SDK platforms get the partner limits). Prices are the same in every class.

shark quotas --json      # {"limits_class": "partner", "raise": "...", "data": [{"name": "awake_spaces", "scope": "tenant", "limit": 100, "used": 12}, ...]}
curl -sS -H "Authorization: Bearer $SHARK_API_KEY" https://api.sharkmagic.si/v1/limits   # class, caps, label caps (no use)

Partner limits#

For design partners and SDK platforms whose own end users each get Spaces: the partner class, set by Shark (ask us; an operator turns it on with one command and it reaches the nodes within seconds). Its numbers are sized to what one node serves: 200 Spaces is the node's per-account ceiling, 100 awake is a quarter of the node's 400 live Spaces. The node's own protections still apply on top of any class: 50 GiB of disk per account, and its admission (503 out_of_capacity while memory or CPU is short, retryable).

Per-label limits#

A platform can cap each of its own end users by a label of their Spaces (Spaces take labels at create, fork and PATCH). A selector key caps each value of that label on its own; key=value caps that one value and wins over key for it. Two counts: awake (Spaces awake at once) and spaces (held). A Space without the label is not capped by it. They only tighten: the account's caps above still apply.

shark quotas labels set end_user --awake 3 --spaces 20     # every end user: 3 awake, 20 held
shark quotas labels set end_user=acme --awake 10            # acme gets 10 awake
shark quotas labels --json                                  # {"class": ..., "label_caps": {"end_user": {"awake": 3, "spaces": 20}, ...}}
shark quotas labels rm end_user=acme
# HTTP (account service): PATCH /v1/limits/labels {"labels": {"end_user": {"awake": 3}}}  (null removes a selector)
#                         PUT   /v1/limits/labels {"labels": {...}}                       (replaces all; null clears)

GET /v1/quotas shows one row per selector and count (scope: label): for key=value its use; for key the fullest value (label, used) and how many values you use (values). A change reaches the nodes within one poll of the account service (about 2 s).

Commands#

Spaces and files#

Secrets, network, terminals#

API#

Not available (today)#

GPUs; non-Linux guests; process memory carried across commands; the services, snapshots, restore, connectors, model-gateway, events and webhooks routes (422 unsupported); stdin streaming; E2B SDK compatibility. shark connect is coming on the hosted node (exposed processes and preview URLs are live: concepts.md).

_{Values: cmd/sharkfs (api_v1*.go, node*.go), internal/apiv1, internal/secrets, and the hosted node's configuration (deploy/v1/shark-api.service) as of 2026-11-05; the account defaults from the account service (control-plane/src/config.ts, DEFAULT_CAPS) as of 2026-11-07. Account quotas can differ per account; GET /v1/quotas tells you yours.}