Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion contract/error-codes.json
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@
"seat_above_sponsor": {
"type": "invalid_request",
"status": 422,
"summary": "The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while it carries the address it was made for or that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it."
"summary": "The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it."
},
"not_a_lens": {
"type": "invalid_request",
Expand Down
4 changes: 2 additions & 2 deletions contract/limits.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"source": "https://www.onlyworlds.com/api/v2/openapi.json: info.x-ow-limits, as served",
"read_at": "2026-10-30",
"read_at": "2026-11-19",
"limits": {
"requests_per_minute": {"value":300,"unit":"requests","per":"60 seconds per key or account token","applies_to":"Every /api/v2 route but the health checks, reads and writes together; a /bulk call is one request. Over it: 429 too_many_requests.","where":null},
"requests_per_minute": {"value":300,"unit":"requests","per":"60 seconds per key or account token","applies_to":"Every route under /api/v2 but the health checks and some of the upload service's own signed reports, reads and writes together; a /bulk call is one request. An OPTIONS request (a browser's preflight) is not counted. The request budget is also spent by a request to the MCP server at /mcp, by a request to the metadata routes (/api/metadata/, /api/worldapi/metadata/) that names a world in ?world= and sends no API-Key, when it carries a Bearer token or keyless reading is switched on, and by requests to some of the site's own pages. Over it: 429 too_many_requests.","where":null},
"requests_per_minute_keyless": {"value":60,"unit":"requests","per":"60 seconds per address","applies_to":"A request with no key and no account token.","where":null},
"changes_head_free_per_minute": {"value":120,"unit":"requests","per":"60 seconds per key or account token","applies_to":"GET /changes?head=true answered 304: given back to the request budget, up to this many.","where":null},
"server_busy_slots": {"value":6,"unit":"requests","per":"server process","applies_to":"Requests in flight at once on every route but the health checks; one past them waits for a slot.","where":null},
Expand Down
4 changes: 2 additions & 2 deletions src/content/docs/api/errors/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ Each code belongs to one family, its `type`, and a family's codes do not share o
| [`player_role_fixed`](#player_role_fixed) | `invalid_request` | `422` | The owner tried to change a player seat's role: a player (no account) reads as a guest, and that role can't be changed. Remove the player instead. |
| [`character_hidden`](#character_hidden) | `invalid_request` | `422` | The owner tried to set a hidden Character as the one a seat or a player plays (`param` character): a played Character is on every reader's roster, so a hidden one can never be picked. Unhide it first, or pick another. |
| [`seat_follows_sponsor`](#seat_follows_sponsor) | `invalid_request` | `422` | The owner tried to set the Character of an AI seat its member made to play their own (`param` character): it plays what that member plays, and may change it only while they may. Hand the seat to yourself first (`sponsor` owner), then pick. |
| [`seat_above_sponsor`](#seat_above_sponsor) | `invalid_request` | `422` | The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while it carries the address it was made for or that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it. |
| [`seat_above_sponsor`](#seat_above_sponsor) | `invalid_request` | `422` | The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it. |
| [`not_a_lens`](#not_a_lens) | `invalid_request` | `422` | A seat chose a Construct that is no lens (`param` lenses): a lens is a Construct with supertype Lens (the lens profile, profiles/lens.md). |
| [`lens_is_template`](#lens_is_template) | `invalid_request` | `422` | A seat chose a template (`param` lenses): a lens with subtype Template reads nothing until it is copied and pointed. Choose a lens with anchors. |
| [`lens_hidden`](#lens_hidden) | `invalid_request` | `422` | A seat chose a hidden lens (`param` lenses): a seat's lenses are on the members list every reader of the world reads, so a hidden one can never be chosen. Unhide it first. |
Expand Down Expand Up @@ -329,7 +329,7 @@ The owner tried to set the Character of an AI seat its member made to play their

**Type** `invalid_request` · **Status** `422`

The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while it carries the address it was made for or that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it.
The owner tried to set an AI seat's role above the role of the person who answers for it (`param` role), or any role above its own while that person is no member of the world: a seat is never above its sponsor. Hand the seat to yourself first (`sponsor` owner), then raise it.

- **How to fix:** send `sponsor` `owner` with the `role`, in one request or before it; the sponsor is set first. To keep the seat with its person, raise that person's role instead. See [No AI above its person](/docs/development/agents#the-human-sponsor).

Expand Down
1 change: 1 addition & 0 deletions src/content/docs/docs/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ What changed on onlyworlds.com for everyone is on its own [Changelog](https://ww

## 2026-11-19

- **[Changes](/docs/development/api/changes#the-feed): an element hidden while a page is read stays out of it.** A contributor, a guest or the public reader is no longer served the body of an element hidden while its page was being read. The [errors page](/api/errors/#seat_above_sponsor)'s `seat_above_sponsor` no longer mentions a seat made for an address, and the [limits](/docs/development/api-reference#limits) snapshot carries the request budget's new description of what it counts.
<!-- toolkit v5.11.6: no docs change (the packs' skills follow serials 135 and 136, the standing work item, done only from open or taken, the design state on any Object or Construct; the profile and reader pages already say so, and the toolkit page restates no pack wording) -->
- **[Changes](/docs/development/api/changes#the-feed): a page's `head` is read before the page.** A page now holds only the changes up to the world's change sequence as it began to be read, and its `head` is that number, so a write made while a page was being read is never skipped: it comes on a later read from the page's cursor. An element deleted while a page is read is left out of it, with its `delete` on this page or later, where such a page could answer `500` before.
- **[Limits](/docs/development/api-reference#limits): what the request budget does not count.** A browser's `OPTIONS` preflight is never counted, and a read of the Classic API's metadata routes with an account token is counted, as one with no key is.
Expand Down
2 changes: 2 additions & 0 deletions src/content/docs/docs/development/api/changes.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,8 @@ An `upsert` carries the whole element at its latest state, in the same body a [r

An element deleted while a page is being read is left out of that page, and its `delete` comes on this page or later in the feed from the cursor the page gives (since 2026-11-19; before, such a page could answer `500`).

An element hidden while a page is being read is not served on that page to a reader the hidden mark keeps it from: a contributor, a guest or the public reader (since 2026-11-19; before, such a page could carry the body of an element hidden a moment earlier). What that reader learns of the hide comes later in the feed, as [Full export](#full-export) and [Guests' cursors](#guests-cursors) describe; a contributor may miss its own creation on that page, and gets it back at the hide's row on its next read.

## Walking the feed

Pass the returned `cursor` back as `?since=` until `has_more` is `false`. Store the last cursor; next time, start from it.
Expand Down
Loading