{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["api-container","api-content","endpoint","api-examples","code-group","tabs","tab"]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Get a sealed store's limits","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"get-a-sealed-stores-limits","__idx":0},"children":["Get a sealed store's limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns the store's published limits (the live-record cap of each kind, the sealed-payload ceiling, the history depth and the 30-day retention) and how many live records of each kind the caller holds."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A client checks a save against these before it starts. The payload ceiling counts the decoded bytes of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]}," alone, not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wrapped_dek"]},"."]},{"$$mdtype":"Tag","name":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"GET","path":"https://api.aitronos.com/v1/sealed-stores/{store}"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"path-parameters","__idx":1},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["store"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The store: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aitronos-browser"]},". Up to 64 characters; an unknown store is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 SEALED_STORE_NOT_FOUND"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"headers","__idx":2},"children":["Headers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer <access token>"]}," from the person's own sign-in. API keys and service accounts are refused with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 SEALED_STORE_PERSONAL_SESSION_REQUIRED"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":3},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["object"]}]}," string — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sealed_store"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["store"]}]}," string — the store's name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kinds"]}]}," array — one entry per record kind the store holds:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kind"]}]}," string — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["session"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["favourites"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_live_records"]}]}," integer — the most live records of this kind one person may hold."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live_records"]}]}," integer — how many the caller holds now. Deleted records do not count."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limits"]}]}," object — the published limits:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload_max_bytes"]}]}," integer — the most decoded bytes of one record's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]}," (524,288)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload_min_bytes"]}]}," integer — the fewest decoded bytes of a sealed value: a 12-byte nonce plus a 16-byte tag (28)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload_ceiling_counts"]}]}," string — always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload"]},": the ceiling counts the payload only, not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wrapped_dek"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["superseded_payload_max_bytes"]}]}," integer — the most decoded bytes of one superseded entry's payload (65,536)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["superseded_max_per_record"]}]}," integer — superseded entries one record holds within the retention (200)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["superseded_max_per_store"]}]}," integer — superseded entries one store holds within the retention (2,000)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_key_max_bytes"]}]}," integer — the most decoded bytes of the account key blob (2,048)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["history_max_revisions"]}]}," integer — revisions kept per record, newest first (100)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["history_max_per_store"]}]}," integer — revisions kept across all of the store's records, newest first (1,000)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tombstones_max_per_store"]}]}," integer — deleted records kept per store (500). Deleting past it removes the oldest tombstone early, and feed cursors from before that are then refused as expired."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operations_max_per_store"]}]}," integer — remembered ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," answers per store, each also for at most the retention (50,000). A retry whose answer is gone is applied again under the record's own rules: its id, its revision or its key."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retention_days"]}]}," integer — how long tombstones, history, superseded entries, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," answers and feed cursors are kept (30)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["feed_max_limit"]}]}," integer — the largest ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," one feed page accepts (500)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["feed_page_max_payload_bytes"]}]}," integer — the decoded payload bytes after which a feed page stops early (8,388,608)."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["wrapped_key_version"]}]}," integer — the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v"]}," of every wrapped key the store returns (1)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":4},"children":["Errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When"},"children":["When"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No access token, or one that is not valid."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SEALED_STORE_PERSONAL_SESSION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call used an API key or a service account. Only a person's own sign-in session reaches a sealed store."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SEALED_STORE_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No store with that name (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.store"]},")."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["store"]}," is longer than 64 characters."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ApiExamples","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"dropdown"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl \"https://api.aitronos.com/v1/sealed-stores/aitronos-browser\" \\\n  -H \"Authorization: Bearer $ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"import os\n\nimport requests\n\nresponse = requests.get(\n    \"https://api.aitronos.com/v1/sealed-stores/aitronos-browser\",\n    headers={\"Authorization\": f\"Bearer {os.environ['AITRONOS_TOKEN']}\"},\n    timeout=30,\n)\nstore = response.json()\nlimits = store[\"limits\"]\nfor kind in store[\"kinds\"]:\n    print(kind[\"kind\"], kind[\"max_live_records\"] - kind[\"live_records\"], \"more allowed\")\n# The ceiling counts the decoded payload alone, not wrapped_dek.\nprint(\"largest payload:\", limits[\"payload_max_bytes\"], \"bytes\")\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","data-title":"JavaScript","header":{"title":"JavaScript","controls":{"copy":{}}},"source":"const response = await fetch(\"https://api.aitronos.com/v1/sealed-stores/aitronos-browser\", {\n  headers: { Authorization: `Bearer ${process.env.AITRONOS_TOKEN}` },\n});\nconst store = await response.json();\nfor (const kind of store.kinds) {\n  console.log(kind.kind, kind.max_live_records - kind.live_records, \"more allowed\");\n}\n// The ceiling counts the decoded payload alone, not wrapped_dek.\nconsole.log(\"largest payload:\", store.limits.payload_max_bytes, \"bytes\");\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"200 OK","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"object\": \"sealed_store\",\n  \"store\": \"aitronos-browser\",\n  \"kinds\": [\n    {\n      \"kind\": \"session\",\n      \"max_live_records\": 500,\n      \"live_records\": 37\n    },\n    {\n      \"kind\": \"favourites\",\n      \"max_live_records\": 1,\n      \"live_records\": 1\n    }\n  ],\n  \"limits\": {\n    \"payload_max_bytes\": 524288,\n    \"payload_min_bytes\": 28,\n    \"payload_ceiling_counts\": \"payload\",\n    \"superseded_payload_max_bytes\": 65536,\n    \"superseded_max_per_record\": 200,\n    \"superseded_max_per_store\": 2000,\n    \"account_key_max_bytes\": 2048,\n    \"history_max_revisions\": 100,\n    \"history_max_per_store\": 1000,\n    \"tombstones_max_per_store\": 500,\n    \"operations_max_per_store\": 50000,\n    \"retention_days\": 30,\n    \"feed_max_limit\": 500,\n    \"feed_page_max_payload_bytes\": 8388608\n  },\n  \"wrapped_key_version\": 1\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"403 Not a personal session","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SEALED_STORE_PERSONAL_SESSION_REQUIRED\",\n    \"message\": \"Sign in on this device to sync your sessions.\",\n    \"system_message\": \"sealed stores are reached with a person's own sign-in session; API keys and service accounts are refused\",\n    \"type\": \"authorization_error\",\n    \"status\": 403,\n    \"details\": {},\n    \"trace_id\": \"d5a2e7f9-2031-48e0-bf3f-ae7396726fce\",\n    \"timestamp\": \"2026-10-10T08:12:55.640917Z\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"404 Unknown store","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SEALED_STORE_NOT_FOUND\",\n    \"message\": \"That sync store doesn't exist.\",\n    \"system_message\": \"no sealed store named 'browser'\",\n    \"type\": \"client_error\",\n    \"status\": 404,\n    \"details\": {\n      \"store\": \"browser\"\n    },\n    \"trace_id\": \"49bb20bd-2237-471d-8f4a-d4a5ce0d15f4\",\n    \"timestamp\": \"2026-10-10T08:13:20.019372Z\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":5},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/sealed-stores/introduction"},"children":["Sealed stores"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/sealed-stores/create-record"},"children":["Create a sealed record"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/sealed-stores/list-changes"},"children":["List sealed store changes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/sealed-stores/list-deleted"},"children":["List deleted sealed records"]}]}]}]},"headings":[{"value":"Get a sealed store's limits","id":"get-a-sealed-stores-limits","depth":1},{"value":"Path Parameters","id":"path-parameters","depth":4},{"value":"Headers","id":"headers","depth":4},{"value":"Returns","id":"returns","depth":2},{"value":"Errors","id":"errors","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Get a sealed store's limits","keywords":["sealed store","limits","caps","retention","payload ceiling"],"seo":{"title":"Get a sealed store's limits"}},"lastModified":"2026-10-26T18:32:31.651Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/sealed-stores/get-store","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}