{"openapi": "3.1.0", "info": {"title": "OnlyWorlds API", "version": "2.0", "description": "\nThe OnlyWorlds platform API: worlds of typed, linked elements (22 types), served\nfor any tool to read and write.\n\n**Authentication** is header-based, per world. `API-Key` names the world\n(a scoped `ow_r_`/`ow_w_` key from your [account page](/account/), or a classic\n10-digit key). Writes also require your 4-digit `API-Pin`: the key says which\nworld, the PIN proves it's you. `ow_r_` read keys work bare and are made for\nsharing.\n\n**The classic API** (used by most existing tools, guides, and SDK versions)\nlives at `/api/worldapi/` and keeps working indefinitely, with the same data in\nthe original wire format. It is documented in the\n[developer reference](https://onlyworlds.github.io/docs/development/api-reference)\nrather than here. New integrations should prefer this API: one-shape links,\nbulk writes with cycle resolution, a `/changes` sync feed, and honest errors.\n"}, "paths": {"/api/v2/health": {"get": {"operationId": "core_api_health", "summary": "Health", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "Unauthenticated liveness probe \u2014 Render's healthCheckPath (render.yaml).\n\nDeliberately checks NOTHING beyond process-up: Render restarts on health\nfailure, so wiring the DB in here would turn a transient DB blip into a\nrestart loop. Dependency state is /health/deep's job."}}, "/api/v2/health/deep": {"get": {"operationId": "core_api_health_deep", "summary": "Health Deep", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "Dependency probe for operators and the cutover watch \u2014 NOT wired to\nRender's health check (see /health). Reports per-component status; 200\nonly when all pass, else 503 with the failing components named."}}, "/api/v2/ability": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/ability/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/ability/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/collective": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/collective/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/collective/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/character": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/character/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/character/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/construct": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/construct/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/construct/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/creature": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/creature/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/creature/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/event": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/event/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/event/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/family": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/family/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/family/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/institution": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/institution/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/institution/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/language": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/language/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/language/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/law": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/law/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/law/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/location": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/location/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/location/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/map": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/map/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/map/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/marker": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/marker/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/marker/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/narrative": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/narrative/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/narrative/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/object": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/object/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/object/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/phenomenon": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/phenomenon/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/phenomenon/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/pin": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/pin/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/pin/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/relation": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/relation/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/relation/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/species": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/species/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/species/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/title": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/title/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/title/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/trait": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/trait/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/trait/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/zone": {"get": {"operationId": "elements_api_list_elements", "summary": "List Elements", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "elements_api_create_element", "summary": "Create Element", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/zone/{id}": {"get": {"operationId": "elements_api_get_element", "summary": "Get Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "put": {"operationId": "elements_api_put_element", "summary": "Put Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "patch": {"operationId": "elements_api_patch_element", "summary": "Patch Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "delete": {"operationId": "elements_api_delete_element", "summary": "Delete Element", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/zone/{id}/links/{field}": {"post": {"operationId": "elements_api_links", "summary": "Links", "parameters": [{"in": "path", "name": "id", "schema": {"title": "Id", "type": "string"}, "required": true}, {"in": "path", "name": "field", "schema": {"title": "Field", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/changes": {"get": {"operationId": "core_changes_changes", "summary": "Changes", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}}, "/api/v2/world": {"get": {"operationId": "core_world_api_world", "summary": "World", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "READ. Carries an ETag; a matching If-None-Match short-circuits to 304.\n\nAuth runs FIRST, always \u2014 the 304 is a post-authentication shortcut, so a\ncaller without a valid credential gets 401 and never learns whether the\nworld (or that ETag) exists.", "x-ow-scope": "READ"}, "patch": {"operationId": "core_world_api_patch_world", "summary": "Patch World", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/bulk": {"post": {"operationId": "core_bulk_api_bulk", "summary": "Bulk", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/account": {"get": {"operationId": "accounts_api_get_profile", "summary": "Get Profile", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "patch": {"operationId": "accounts_api_patch_profile", "summary": "Patch Profile", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/account/worlds": {"get": {"operationId": "accounts_api_list_worlds", "summary": "List Worlds", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}, "post": {"operationId": "accounts_api_create_world", "summary": "Create World", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "Create a world \u2192 201 with the world + a freshly minted ow_w_ key (shown\nONCE).\n\nR12 (D54) \u2014 the PIN invariant, portal-exact: NO world may exist without a\nPIN wall, and the wall is the ACCOUNT PIN, inherited as the already-argon2'd\nhash (no re-hash, same as the migration fan and portal world_create).\nA pinless account must send `pin` (4 digits, 1000-9999) with its first\nworld \u2014 the account PIN is set FIRST, in the same transaction, so the world\ncan never come into existence pinless. A pinned account sends name only;\n`pin` alongside an existing account PIN is a loud 422 (PIN changes go\nthrough the account PIN change flow, which re-fans per R3).", "x-ow-scope": "WRITE"}}, "/api/v2/account/worlds/{world_id}/keys": {"post": {"operationId": "accounts_api_mint_world_key", "summary": "Mint World Key", "parameters": [{"in": "path", "name": "world_id", "schema": {"title": "World Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}, "get": {"operationId": "accounts_api_list_world_keys", "summary": "List World Keys", "parameters": [{"in": "path", "name": "world_id", "schema": {"title": "World Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}}, "/api/v2/account/worlds/{world_id}/keys/{key_id}": {"delete": {"operationId": "accounts_api_revoke_world_key", "summary": "Revoke World Key", "parameters": [{"in": "path", "name": "world_id", "schema": {"title": "World Id", "type": "string"}, "required": true}, {"in": "path", "name": "key_id", "schema": {"title": "Key Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/account/watched": {"get": {"operationId": "accounts_api_list_watched", "summary": "List Watched", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "Decrypt each key, fetch the world name, mark stale (not delete) if the key\nnow fails to resolve \u2014 revocation is the owner's surface, the watcher sees\nit went stale.", "x-ow-scope": "READ"}, "post": {"operationId": "accounts_api_add_watched", "summary": "Add Watched", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "Validate the pasted key is a LIVE ow_r_ before storing it (encrypted).", "x-ow-scope": "WRITE"}}, "/api/v2/account/watched/{watch_id}": {"delete": {"operationId": "accounts_api_remove_watched", "summary": "Remove Watched", "parameters": [{"in": "path", "name": "watch_id", "schema": {"title": "Watch Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}, "/api/v2/account/tokens": {"post": {"operationId": "accounts_api_mint_token", "summary": "Mint Token", "parameters": [], "responses": {"200": {"description": "OK"}}, "description": "Mint an ow_a_ account token. Full token shown ONCE.", "x-ow-scope": "WRITE"}, "get": {"operationId": "accounts_api_list_tokens", "summary": "List Tokens", "parameters": [], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "READ"}}, "/api/v2/account/tokens/{token_id}": {"delete": {"operationId": "accounts_api_revoke_token", "summary": "Revoke Token", "parameters": [{"in": "path", "name": "token_id", "schema": {"title": "Token Id", "type": "string"}, "required": true}], "responses": {"200": {"description": "OK"}}, "x-ow-scope": "WRITE"}}}, "components": {"schemas": {}}, "servers": []}