{"openapi": "3.1.0", "info": {"title": "Knos", "version": "0.4.1", "description": "The goal: Knos carries research across the valley of death. Demand checks on Qloo, Ready briefs, milestone money held on Solana devnet until the milestone check passes, and research claims proved by agents on NEAR testnet; test money, no customers yet. Agents: the same tools over MCP at /mcp."}, "servers": [{"url": "https://knos.onrender.com"}], "components": {"securitySchemes": {"session": {"type": "http", "scheme": "bearer", "description": "the session token a sign-in returns (passkey, SSO, Google, ORCID, email, guest)"}}}, "paths": {"/": {"get": {"summary": "301 to the front door, https://drexthealpha.github.io/Knos/", "operationId": "get", "responses": {"301": {"description": "moved: https://drexthealpha.github.io/Knos/", "headers": {"Location": {"schema": {"type": "string"}, "example": "https://drexthealpha.github.io/Knos/"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/.well-known/agent-card.json": {"get": {"summary": "The A2A 1.0 Agent Card: the MCP endpoint, the OAuth 2.0 client-credentials flow, the skills", "operationId": "get_.well-known_agent-card.json", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/.well-known/ai-catalog.json": {"get": {"summary": "The AI catalog: the MCP Server Card, the OpenAPI document and llms.txt", "operationId": "get_.well-known_ai-catalog.json", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/.well-known/oauth-authorization-server": {"get": {"summary": "OAuth 2.0 authorization server metadata (RFC 8414): client credentials only", "operationId": "get_.well-known_oauth-authorization-server", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/.well-known/oauth-protected-resource": {"get": {"summary": "OAuth 2.0 protected resource metadata (RFC 9728): the MCP endpoint", "operationId": "get_.well-known_oauth-protected-resource", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/.well-known/oauth-protected-resource/mcp": {"get": {"summary": "The same metadata at the resource's own path (RFC 9728 section 3.1)", "operationId": "get_.well-known_oauth-protected-resource_mcp", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/actions.json": {"get": {"summary": "Solana Actions rules", "operationId": "get_actions.json", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/actions/preorder": {"get": {"summary": "Solana Action (Blink): pre-order metadata", "operationId": "get_api_actions_preorder", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "report", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff051897a9799ed592e7a6875bce6559c1c19fa67b0be41899c0"}]}}, "/api/agent/keys": {"get": {"summary": "Your agent keys: caps, counters and state (never a secret)", "operationId": "get_api_agent_keys", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}, "post": {"summary": "Make a capped, revocable agent key (shown once): an OAuth 2.0 client for /oauth/token", "operationId": "post_api_agent_keys", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"label": {"type": "string"}, "max_claims": {"type": "integer"}, "max_spend_units": {"type": "integer"}, "days": {"type": "integer"}, "payout_wallet": {"type": "string"}}}}}}}}, "/api/agent/keys/revoke": {"post": {"summary": "Revoke one of your agent keys: it and its access tokens stop at once", "operationId": "post_api_agent_keys_revoke", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"id": {"type": "string"}}}}}}}}, "/api/agent/payout/latest": {"get": {"summary": "The newest payout to an agent, read from devnet", "operationId": "get_api_agent_payout_latest", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/anchor": {"post": {"summary": "Anchor the record root on devnet", "operationId": "post_api_anchor", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/ask": {"post": {"summary": "POST /api/ask", "operationId": "post_api_ask", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/attest": {"get": {"summary": "in-toto Statement v1 in a DSSE envelope for an attempt's evidence", "operationId": "get_api_attest", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "project", "in": "query", "required": true, "schema": {"type": "string"}, "example": "7b4ed16b8c2903dc"}, {"name": "milestone", "in": "query", "required": true, "schema": {"type": "string"}, "example": "preorders"}, {"name": "attempt", "in": "query", "required": true, "schema": {"type": "string"}, "example": "46088348e3"}]}}, "/api/attest/key": {"get": {"summary": "This server's ed25519 attestation key", "operationId": "get_api_attest_key", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/auth/challenge": {"post": {"summary": "POST /api/auth/challenge", "operationId": "post_api_auth_challenge", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/auth/config": {"get": {"summary": "Sign-in providers", "operationId": "get_api_auth_config", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/auth/email": {"post": {"summary": "POST /api/auth/email", "operationId": "post_api_auth_email", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/auth/email/verify": {"post": {"summary": "POST /api/auth/email/verify", "operationId": "post_api_auth_email_verify", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/auth/google": {"post": {"summary": "POST /api/auth/google", "operationId": "post_api_auth_google", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/auth/guest": {"post": {"summary": "POST /api/auth/guest", "operationId": "post_api_auth_guest", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/auth/passkey/login": {"post": {"summary": "POST /api/auth/passkey/login", "operationId": "post_api_auth_passkey_login", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/auth/passkey/register": {"post": {"summary": "POST /api/auth/passkey/register", "operationId": "post_api_auth_passkey_register", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/buyer/confirm": {"post": {"summary": "POST /api/buyer/confirm", "operationId": "post_api_buyer_confirm", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/buyer/start": {"post": {"summary": "POST /api/buyer/start", "operationId": "post_api_buyer_start", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/calls": {"get": {"summary": "The last 200 Qloo requests this server made or recorded: time, endpoint, parameters, status, ms, cached; never a body", "operationId": "get_api_calls", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/check": {"post": {"summary": "Demand check on Qloo", "operationId": "post_api_check", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"idea": {"type": "string", "description": "the product idea, 3 to 500 characters", "examples": ["a cold brew coffee shop"]}, "place": {"type": "string", "description": "the launch market (city or country)", "examples": ["Austin"]}, "leader": {"type": "string", "description": "the market leader to compare against", "examples": ["Starbucks"]}, "age": {"type": "string", "description": "Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older", "examples": ["35_to_44"]}, "gender": {"type": "string", "enum": ["male", "female"], "description": "Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender.", "examples": ["female"]}, "audiences": {"type": "string", "description": "Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences.", "examples": ["urn:audience:hobbies_and_interests:running"]}, "interests_names": {"type": "array", "items": {"type": "string"}, "description": "Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string", "examples": ["Hoka, Salomon"]}, "audiences_weight": {"type": "string", "enum": ["low", "medium", "high", "higher"], "description": "Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight.", "examples": ["high"]}, "hide_leader": {"type": "boolean", "description": "What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities.", "examples": [true]}, "exclude": {"type": "string", "description": "What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities.", "examples": ["4BBEF799-A0C4-4110-AB01-39216993C312"]}, "exclude_names": {"type": "array", "items": {"type": "string"}, "description": "What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string", "examples": ["Nike, Adidas"]}, "exclude_tags": {"type": "string", "description": "What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags.", "examples": ["urn:tag:genre:media:horror"]}, "exclude_tags_operator": {"type": "string", "enum": ["union", "intersection"], "description": "What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags.", "examples": ["union"]}, "popularity_max": {"type": "number", "description": "What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max.", "examples": [0.5]}, "popularity_min": {"type": "number", "description": "What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min.", "examples": [0.1]}, "results_query": {"type": "string", "description": "What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query.", "examples": ["Fitbit"]}, "near": {"type": "string", "description": "Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query.", "examples": ["Austin"]}, "radius": {"type": "integer", "description": "Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius.", "examples": [5000]}, "location": {"type": "string", "description": "Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location.", "examples": ["POINT(-97.7431 30.2672)"]}, "geohash": {"type": "string", "description": "Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash.", "examples": ["9v6k"]}, "exclude_near": {"type": "string", "description": "Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query.", "examples": ["Downtown Austin"]}, "exclude_location": {"type": "string", "description": "Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location.", "examples": ["POINT(-97.74 30.27)"]}, "exclude_geohash": {"type": "string", "description": "Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash.", "examples": ["9v6kp"]}, "city": {"type": "string", "description": "Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name.", "examples": ["Austin"]}, "admin1": {"type": "string", "description": "Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region.", "examples": ["Texas"]}, "admin2": {"type": "string", "description": "Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region.", "examples": ["Travis County"]}, "country": {"type": "string", "description": "Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code.", "examples": ["US"]}, "price_level": {"type": "string", "description": "At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4", "examples": ["1"]}, "hotel_class": {"type": "string", "description": "At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5", "examples": ["4,5"]}, "price_from": {"type": "integer", "description": "At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from.", "examples": [100]}, "price_to": {"type": "integer", "description": "At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to.", "examples": [300]}, "price_level_min": {"type": "integer", "description": "At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min.", "examples": [2]}, "price_level_max": {"type": "integer", "description": "At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max.", "examples": [3]}, "hotel_class_min": {"type": "integer", "description": "At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min.", "examples": [3]}, "hotel_class_max": {"type": "integer", "description": "At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max.", "examples": [5]}, "business_rating_min": {"type": "number", "description": "At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min.", "examples": [3.5]}, "business_rating_max": {"type": "number", "description": "At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max.", "examples": [5.0]}, "references_brand": {"type": "string", "description": "Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand.", "examples": ["Whole Foods Market"]}, "quality": {"type": "string", "enum": ["low", "medium", "high"], "description": "Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality.", "examples": ["high"]}, "sort": {"type": "string", "enum": ["affinity", "distance", "rating", "quality"], "description": "Who serves or stocks it (F5): Order places by. Qloo: sort_by.", "examples": ["quality"]}, "open_on": {"type": "string", "description": "Who serves or stocks it (F5): Open on this day. Qloo: filter.hours.", "examples": ["Sunday"]}, "address": {"type": "string", "description": "Who serves or stocks it (F5): Address contains. Qloo: filter.address.", "examples": ["Congress Ave"]}, "tripadvisor_rating_min": {"type": "number", "description": "Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min.", "examples": [4.0]}, "tripadvisor_rating_max": {"type": "number", "description": "Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max.", "examples": [5.0]}, "tripadvisor_count_min": {"type": "integer", "description": "Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min.", "examples": [100]}, "tripadvisor_count_max": {"type": "integer", "description": "Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max.", "examples": [5000]}, "resy_rating_min": {"type": "number", "description": "Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min.", "examples": [4.0]}, "resy_rating_max": {"type": "number", "description": "Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max.", "examples": [5.0]}, "resy_count_min": {"type": "integer", "description": "Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min.", "examples": [100]}, "resy_count_max": {"type": "integer", "description": "Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max.", "examples": [10000]}, "resy_party_min": {"type": "integer", "description": "Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min.", "examples": [2]}, "resy_party_max": {"type": "integer", "description": "Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max.", "examples": [8]}, "external": {"type": "string", "description": "Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet", "examples": ["resy"]}, "external_operator": {"type": "string", "enum": ["union", "intersection"], "description": "Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists.", "examples": ["union"]}, "product_kind": {"type": "string", "enum": ["film", "tv", "book", "person", "artist", "brand", "podcast", "game", "place", "destination"], "description": "Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type.", "examples": ["film"]}, "content_rating": {"type": "string", "description": "Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating.", "examples": ["PG-13"]}, "year_min": {"type": "integer", "description": "Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min.", "examples": [2015]}, "year_max": {"type": "integer", "description": "Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max.", "examples": [2024]}, "release_country": {"type": "string", "description": "Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country.", "examples": ["United States"]}, "release_country_operator": {"type": "string", "enum": ["union", "intersection"], "description": "Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country.", "examples": ["union"]}, "rating_min": {"type": "number", "description": "Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min.", "examples": [3.5]}, "rating_max": {"type": "number", "description": "Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max.", "examples": [5.0]}, "finale_year_min": {"type": "integer", "description": "Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min.", "examples": [2018]}, "finale_year_max": {"type": "integer", "description": "Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max.", "examples": [2024]}, "latest_year_min": {"type": "integer", "description": "Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min.", "examples": [2020]}, "latest_year_max": {"type": "integer", "description": "Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max.", "examples": [2025]}, "born_min": {"type": "string", "description": "Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min.", "examples": ["1960-01-01"]}, "born_max": {"type": "string", "description": "Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max.", "examples": ["1990-12-31"]}, "died_min": {"type": "string", "description": "Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min.", "examples": ["2000-01-01"]}, "died_max": {"type": "string", "description": "Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max.", "examples": ["2020-12-31"]}, "person_gender": {"type": "string", "enum": ["male", "female"], "description": "Media and people products (F6): Person: gender. Qloo: filter.gender.", "examples": ["female"]}, "lookup": {"type": "string", "description": "Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query.", "examples": ["Austin"]}, "lookup_types": {"type": "string", "description": "Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame", "examples": ["urn:entity:locality"]}, "lookup_near": {"type": "string", "description": "Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location.", "examples": ["30.2672,-97.7431"]}, "lookup_radius": {"type": "number", "description": "Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius.", "examples": [10]}, "lookup_sort": {"type": "string", "enum": ["match", "distance", "popularity"], "description": "Look up exact things (F7): Order the search by. Qloo: sort_by.", "examples": ["match"]}, "entity_id": {"type": "string", "description": "Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids.", "examples": ["B2A5BF4D-6D9A-4A8B-9E50-1A2B3C4D5E6F"]}, "qloo": {"type": "object", "additionalProperties": true, "description": "Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.", "examples": [{"bias.trends": "high"}]}, "qloo_calls": {"type": "object", "additionalProperties": true, "description": "Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.", "examples": [{"/v2/tags": {"filter.query": "trail running", "feature.semantic_search": "true"}}]}}, "required": ["idea"], "additionalProperties": false}, "examples": {"who-and-where": {"summary": "Who and where", "value": {"idea": "trail running shoes for ultramarathons", "age": "24_and_younger", "near": "Austin", "radius": 5000}}, "price-and-brand": {"summary": "Price tier and who serves it", "value": {"idea": "a cold brew coffee shop", "near": "Seattle", "price_level": "1", "references_brand": "Starbucks"}}}}}}}}, "/api/commitment": {"get": {"summary": "One commitment", "operationId": "get_api_commitment", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "x-example-from": {"method": "GET", "path": "/api/commitments", "pick": "commitments.0.commitment"}}]}}, "/api/commitments": {"get": {"summary": "Pre-orders and funders' held money", "operationId": "get_api_commitments", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "take", "in": "query", "required": false, "schema": {"type": "integer"}, "example": 5}]}}, "/api/companies": {"get": {"summary": "Companies and their multisigs", "operationId": "get_api_companies", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/company/confirm": {"post": {"summary": "Mark a company's multisig created once it is on devnet", "operationId": "post_api_company_confirm", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"company": {"type": "string"}, "signature": {"type": "string"}}}}}}}}, "/api/company/export": {"get": {"summary": "A project's ledger as journal, Xero, QuickBooks or NetSuite CSV", "operationId": "get_api_company_export", "responses": {"200": {"description": "OK", "content": {"text/csv": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "project", "in": "query", "required": true, "schema": {"type": "string"}, "example": "7b4ed16b8c2903dc"}, {"name": "format", "in": "query", "required": false, "schema": {"type": "string"}, "example": "xero"}]}}, "/api/company/multisig": {"post": {"summary": "The devnet transaction that creates a company's Squads multisig (its creator signs)", "operationId": "post_api_company_multisig", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"name": {"type": "string"}, "members": {"type": "array", "items": {}}, "threshold": {"type": "integer"}, "creator": {"type": "string"}}}}}}}}, "/api/company/need": {"post": {"summary": "Companies: one sentence to a Ready brief, a private demand check and an opened milestone", "operationId": "post_api_company_need", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/counter": {"get": {"summary": "Live checks today and this week, checks by others, devnet pre-orders held and released, feedback answers", "operationId": "get_api_counter", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/cross": {"post": {"summary": "Start a crossing", "operationId": "post_api_cross", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"ref": {"type": "string", "description": "a paper id (DOI, arXiv, PubMed, OpenAlex, patent)", "examples": ["10.1038/nature16521"]}, "idea": {"type": "string", "description": "the product idea, 3 to 500 characters", "examples": ["a cold brew coffee shop"]}, "place": {"type": "string", "description": "the launch market (city or country)", "examples": ["Austin"]}, "leader": {"type": "string", "description": "the market leader to compare against", "examples": ["Starbucks"]}, "product": {"type": "string", "description": "the product phrase"}, "age": {"type": "string", "description": "Who wants it (F1): Who: age range(s) the answer is weighted to. Qloo: signal.demographics.age. comma-separated, of: 24_and_younger, 25_to_29, 30_to_34, 35_to_44, 45_to_54, 55_and_older", "examples": ["35_to_44"]}, "gender": {"type": "string", "enum": ["male", "female"], "description": "Who wants it (F1): Who: gender the answer is weighted to. Qloo: signal.demographics.gender.", "examples": ["female"]}, "audiences": {"type": "string", "description": "Who wants it (F1): Audience segment ids (from /v2/audiences). Qloo: signal.demographics.audiences.", "examples": ["urn:audience:hobbies_and_interests:running"]}, "interests_names": {"type": "array", "items": {"type": "string"}, "description": "Who wants it (F1): Steer the answer by things you name (Qloo resolves them; sent as JSON). Qloo: signal.interests.entities.query. names, or one comma-separated string", "examples": ["Hoka, Salomon"]}, "audiences_weight": {"type": "string", "enum": ["low", "medium", "high", "higher"], "description": "Who wants it (F1): How much the segments steer the answer. Qloo: signal.demographics.audiences.weight.", "examples": ["high"]}, "hide_leader": {"type": "boolean", "description": "What is underserved (F2): Gaps: hide the market leader (its Qloo id is excluded). Qloo: filter.exclude.entities.", "examples": [true]}, "exclude": {"type": "string", "description": "What is underserved (F2): Entity ids to leave out. Qloo: filter.exclude.entities.", "examples": ["4BBEF799-A0C4-4110-AB01-39216993C312"]}, "exclude_names": {"type": "array", "items": {"type": "string"}, "description": "What is underserved (F2): Leave out things by name (Qloo resolves them; sent as JSON). Qloo: filter.exclude.entities.query. names, or one comma-separated string", "examples": ["Nike, Adidas"]}, "exclude_tags": {"type": "string", "description": "What is underserved (F2): Tag ids to leave out. Qloo: filter.exclude.tags.", "examples": ["urn:tag:genre:media:horror"]}, "exclude_tags_operator": {"type": "string", "enum": ["union", "intersection"], "description": "What is underserved (F2): Leave out results with any (union) or all (intersection) of those tags. Qloo: operator.exclude.tags.", "examples": ["union"]}, "popularity_max": {"type": "number", "description": "What is underserved (F2): Gaps: niche only, popularity at most this percentile (0-1). Qloo: filter.popularity.max.", "examples": [0.5]}, "popularity_min": {"type": "number", "description": "What is underserved (F2): Popularity at least this percentile (0-1). Qloo: filter.popularity.min.", "examples": [0.1]}, "results_query": {"type": "string", "description": "What is underserved (F2): Score only these named things (one name). Qloo: filter.results.entities.query.", "examples": ["Fitbit"]}, "near": {"type": "string", "description": "Where to launch (F3): Where: a city or region by name. Qloo: filter.location.query.", "examples": ["Austin"]}, "radius": {"type": "integer", "description": "Where to launch (F3): Where: radius around it, in meters (0 = strictly inside). Qloo: filter.location.radius.", "examples": [5000]}, "location": {"type": "string", "description": "Where to launch (F3): A WKT POINT/POLYGON (longitude first) or a locality id. Qloo: filter.location.", "examples": ["POINT(-97.7431 30.2672)"]}, "geohash": {"type": "string", "description": "Where to launch (F3): Only results whose geohash starts with this. Qloo: filter.location.geohash.", "examples": ["9v6k"]}, "exclude_near": {"type": "string", "description": "Where to launch (F3): Leave out an area by name. Qloo: filter.exclude.location.query.", "examples": ["Downtown Austin"]}, "exclude_location": {"type": "string", "description": "Where to launch (F3): Leave out a WKT area or locality id. Qloo: filter.exclude.location.", "examples": ["POINT(-97.74 30.27)"]}, "exclude_geohash": {"type": "string", "description": "Where to launch (F3): Leave out results whose geohash starts with this. Qloo: filter.exclude.location.geohash.", "examples": ["9v6kp"]}, "city": {"type": "string", "description": "Where to launch (F3): Exact city or town name. Qloo: filter.geocode.name.", "examples": ["Austin"]}, "admin1": {"type": "string", "description": "Where to launch (F3): Exact state or region. Qloo: filter.geocode.admin1_region.", "examples": ["Texas"]}, "admin2": {"type": "string", "description": "Where to launch (F3): Exact county or borough. Qloo: filter.geocode.admin2_region.", "examples": ["Travis County"]}, "country": {"type": "string", "description": "Where to launch (F3): Two-letter country code. Qloo: filter.geocode.country_code.", "examples": ["US"]}, "price_level": {"type": "string", "description": "At what price, where (F4): Price tier: 1 (cheap) to 4 (dear), mapped where it is hot. Qloo: filter.dimensions.price_level. comma-separated, of: 1, 2, 3, 4", "examples": ["1"]}, "hotel_class": {"type": "string", "description": "At what price, where (F4): Hotel classes 1-5, mapped where they are hot. Qloo: filter.dimensions.hotel_class. comma-separated, of: 1, 2, 3, 4, 5", "examples": ["4,5"]}, "price_from": {"type": "integer", "description": "At what price, where (F4): Hotel price range from (0-1,000,000). Qloo: filter.price_range.from.", "examples": [100]}, "price_to": {"type": "integer", "description": "At what price, where (F4): Hotel price range to (0-1,000,000). Qloo: filter.price_range.to.", "examples": [300]}, "price_level_min": {"type": "integer", "description": "At what price, where (F4): Places at price level at least (1-4). Qloo: filter.price_level.min.", "examples": [2]}, "price_level_max": {"type": "integer", "description": "At what price, where (F4): Places at price level at most (1-4). Qloo: filter.price_level.max.", "examples": [3]}, "hotel_class_min": {"type": "integer", "description": "At what price, where (F4): Hotel class at least (1-5). Qloo: filter.hotel_class.min.", "examples": [3]}, "hotel_class_max": {"type": "integer", "description": "At what price, where (F4): Hotel class at most (1-5). Qloo: filter.hotel_class.max.", "examples": [5]}, "business_rating_min": {"type": "number", "description": "At what price, where (F4): Business rating at least. Qloo: filter.properties.business_rating.min.", "examples": [3.5]}, "business_rating_max": {"type": "number", "description": "At what price, where (F4): Business rating at most. Qloo: filter.properties.business_rating.max.", "examples": [5.0]}, "references_brand": {"type": "string", "description": "Who serves or stocks it (F5): Who serves it: a brand by name or id; only places tied to it. Qloo: filter.references_brand.", "examples": ["Whole Foods Market"]}, "quality": {"type": "string", "enum": ["low", "medium", "high"], "description": "Who serves or stocks it (F5): Lean the ranking toward quality places. Qloo: bias.quality.", "examples": ["high"]}, "sort": {"type": "string", "enum": ["affinity", "distance", "rating", "quality"], "description": "Who serves or stocks it (F5): Order places by. Qloo: sort_by.", "examples": ["quality"]}, "open_on": {"type": "string", "description": "Who serves or stocks it (F5): Open on this day. Qloo: filter.hours.", "examples": ["Sunday"]}, "address": {"type": "string", "description": "Who serves or stocks it (F5): Address contains. Qloo: filter.address.", "examples": ["Congress Ave"]}, "tripadvisor_rating_min": {"type": "number", "description": "Who serves or stocks it (F5): Tripadvisor rating at least. Qloo: filter.external.tripadvisor.rating.min.", "examples": [4.0]}, "tripadvisor_rating_max": {"type": "number", "description": "Who serves or stocks it (F5): Tripadvisor rating at most. Qloo: filter.external.tripadvisor.rating.max.", "examples": [5.0]}, "tripadvisor_count_min": {"type": "integer", "description": "Who serves or stocks it (F5): Tripadvisor reviews at least. Qloo: filter.external.tripadvisor.rating.count.min.", "examples": [100]}, "tripadvisor_count_max": {"type": "integer", "description": "Who serves or stocks it (F5): Tripadvisor reviews at most. Qloo: filter.external.tripadvisor.rating.count.max.", "examples": [5000]}, "resy_rating_min": {"type": "number", "description": "Who serves or stocks it (F5): Resy rating at least (1-5). Qloo: filter.external.resy.rating.min.", "examples": [4.0]}, "resy_rating_max": {"type": "number", "description": "Who serves or stocks it (F5): Resy rating at most (1-5). Qloo: filter.external.resy.rating.max.", "examples": [5.0]}, "resy_count_min": {"type": "integer", "description": "Who serves or stocks it (F5): Resy rating count at least. Qloo: filter.external.resy.count.min.", "examples": [100]}, "resy_count_max": {"type": "integer", "description": "Who serves or stocks it (F5): Resy rating count at most. Qloo: filter.external.resy.count.max.", "examples": [10000]}, "resy_party_min": {"type": "integer", "description": "Who serves or stocks it (F5): Resy party size at least. Qloo: filter.external.resy.party_size.min.", "examples": [2]}, "resy_party_max": {"type": "integer", "description": "Who serves or stocks it (F5): Resy party size at most. Qloo: filter.external.resy.party_size.max.", "examples": [8]}, "external": {"type": "string", "description": "Who serves or stocks it (F5): Listed on these (resy, michelin, tablet). Qloo: filter.external.exists. comma-separated, of: resy, michelin, tablet", "examples": ["resy"]}, "external_operator": {"type": "string", "enum": ["union", "intersection"], "description": "Who serves or stocks it (F5): Any (union) or all (intersection) of those. Qloo: operator.filter.external.exists.", "examples": ["union"]}, "product_kind": {"type": "string", "enum": ["film", "tv", "book", "person", "artist", "brand", "podcast", "game", "place", "destination"], "description": "Media and people products (F6): Product kind: what the comparables are. Qloo: filter.type.", "examples": ["film"]}, "content_rating": {"type": "string", "description": "Media and people products (F6): Film/TV content rating(s), MPAA. Qloo: filter.content_rating.", "examples": ["PG-13"]}, "year_min": {"type": "integer", "description": "Media and people products (F6): Released from this year (film/TV; books: publication year). Qloo: filter.release_year.min.", "examples": [2015]}, "year_max": {"type": "integer", "description": "Media and people products (F6): Released up to this year (film/TV; books: publication year). Qloo: filter.release_year.max.", "examples": [2024]}, "release_country": {"type": "string", "description": "Media and people products (F6): Film/TV released in these countries. Qloo: filter.release_country.", "examples": ["United States"]}, "release_country_operator": {"type": "string", "enum": ["union", "intersection"], "description": "Media and people products (F6): Any (union) or all (intersection) of those. Qloo: operator.filter.release_country.", "examples": ["union"]}, "rating_min": {"type": "number", "description": "Media and people products (F6): Film/TV Qloo rating at least (0-5). Qloo: filter.rating.min.", "examples": [3.5]}, "rating_max": {"type": "number", "description": "Media and people products (F6): Film/TV Qloo rating at most (0-5). Qloo: filter.rating.max.", "examples": [5.0]}, "finale_year_min": {"type": "integer", "description": "Media and people products (F6): TV: final season from this year. Qloo: filter.finale_year.min.", "examples": [2018]}, "finale_year_max": {"type": "integer", "description": "Media and people products (F6): TV: final season up to this year. Qloo: filter.finale_year.max.", "examples": [2024]}, "latest_year_min": {"type": "integer", "description": "Media and people products (F6): TV: released or updated from this year. Qloo: filter.latest_known_year.min.", "examples": [2020]}, "latest_year_max": {"type": "integer", "description": "Media and people products (F6): TV: released or updated up to this year. Qloo: filter.latest_known_year.max.", "examples": [2025]}, "born_min": {"type": "string", "description": "Media and people products (F6): Person: born on or after (YYYY-MM-DD). Qloo: filter.date_of_birth.min.", "examples": ["1960-01-01"]}, "born_max": {"type": "string", "description": "Media and people products (F6): Person: born on or before (YYYY-MM-DD). Qloo: filter.date_of_birth.max.", "examples": ["1990-12-31"]}, "died_min": {"type": "string", "description": "Media and people products (F6): Person: died on or after (YYYY-MM-DD). Qloo: filter.date_of_death.min.", "examples": ["2000-01-01"]}, "died_max": {"type": "string", "description": "Media and people products (F6): Person: died on or before (YYYY-MM-DD). Qloo: filter.date_of_death.max.", "examples": ["2020-12-31"]}, "person_gender": {"type": "string", "enum": ["male", "female"], "description": "Media and people products (F6): Person: gender. Qloo: filter.gender.", "examples": ["female"]}, "lookup": {"type": "string", "description": "Look up exact things (F7): Look up exact things: a name to find (Search Entities). Qloo: query.", "examples": ["Austin"]}, "lookup_types": {"type": "string", "description": "Look up exact things (F7): What kinds to search. Qloo: types. comma-separated, of: urn:entity:actor, urn:entity:album, urn:entity:artist, urn:entity:author, urn:entity:book, urn:entity:brand, urn:entity:destination, urn:entity:director, urn:entity:locality, urn:entity:movie, urn:entity:person, urn:entity:place, urn:entity:podcast, urn:entity:tv_show, urn:entity:videogame", "examples": ["urn:entity:locality"]}, "lookup_near": {"type": "string", "description": "Look up exact things (F7): Search near: lat,lon or WKT. Qloo: filter.location.", "examples": ["30.2672,-97.7431"]}, "lookup_radius": {"type": "number", "description": "Look up exact things (F7): Search radius in miles (0-100). Qloo: filter.radius.", "examples": [10]}, "lookup_sort": {"type": "string", "enum": ["match", "distance", "popularity"], "description": "Look up exact things (F7): Order the search by. Qloo: sort_by.", "examples": ["match"]}, "entity_id": {"type": "string", "description": "Look up exact things (F7): Look up exact things: paste a Qloo entity id (Search Entities by ID). Qloo: entity_ids.", "examples": ["B2A5BF4D-6D9A-4A8B-9E50-1A2B3C4D5E6F"]}, "qloo": {"type": "object", "additionalProperties": true, "description": "Anything else in the guide (F8): Any other documented parameter for the call's filter.type, by its Qloo name. Qloo: *.", "examples": [{"bias.trends": "high"}]}, "qloo_calls": {"type": "object", "additionalProperties": true, "description": "Anything else in the guide (F8): Calls to Qloo's other endpoints by path, each with its own documented parameters. Qloo: *.", "examples": [{"/v2/tags": {"filter.query": "trail running", "feature.semantic_search": "true"}}]}}, "additionalProperties": false}, "examples": {"who-and-where": {"summary": "Who and where", "value": {"idea": "trail running shoes for ultramarathons", "age": "24_and_younger", "near": "Austin", "radius": 5000}}, "price-and-brand": {"summary": "Price tier and who serves it", "value": {"idea": "a cold brew coffee shop", "near": "Seattle", "price_level": "1", "references_brand": "Starbucks"}}}}}}}, "get": {"summary": "Poll a live crossing", "operationId": "get_api_cross", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "x-example-from": {"method": "POST", "path": "/api/cross", "body": {"ref": "10.1038/nature16521"}, "pick": "id"}}, {"name": "since", "in": "query", "required": false, "schema": {"type": "integer"}, "example": 0}]}}, "/api/cross/stream": {"get": {"summary": "A crossing's steps as Server-Sent Events while it runs", "operationId": "get_api_cross_stream", "responses": {"200": {"description": "OK", "content": {"text/event-stream": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "x-example-from": {"method": "POST", "path": "/api/cross", "body": {"ref": "10.1038/nature16521"}, "pick": "id"}}, {"name": "since", "in": "query", "required": false, "schema": {"type": "integer"}}]}}, "/api/crossings": {"get": {"summary": "Crossings, newest first", "operationId": "get_api_crossings", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "take", "in": "query", "required": false, "schema": {"type": "integer"}, "example": 5}]}}, "/api/demand/fields": {"get": {"summary": "The Qloo demand families F1-F8: every option's name, Qloo parameter, kind, help and example", "operationId": "get_api_demand_fields", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/draft": {"post": {"summary": "Keep the brief you are writing for your passkey (every save is a version)", "operationId": "post_api_draft", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"brief": {"type": "object"}, "title": {"type": "string"}}}}}}}}, "/api/draft/forget": {"post": {"summary": "Forget every draft kept for your passkey", "operationId": "post_api_draft_forget", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/draft/get": {"post": {"summary": "Your latest draft and its timeline, on any device you sign in on", "operationId": "post_api_draft_get", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/evidence/c2pa": {"post": {"summary": "Sign a photo or video with a C2PA manifest naming the claim id (raw body; X-Claim-Id)", "operationId": "post_api_evidence_c2pa", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/evidence/c2pa/verify": {"post": {"summary": "Read a C2PA manifest from a photo or video (raw body)", "operationId": "post_api_evidence_c2pa_verify", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/evidence/evm": {"post": {"summary": "Verify an EVM-signed attestation with Solana's Secp256k1 precompile (a devnet transaction)", "operationId": "post_api_evidence_evm", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"eth_address": {"type": "string"}, "signature": {"type": "string"}, "message": {"type": "string"}}}}}}}}, "/api/factor": {"post": {"summary": "Receivable financing offer", "operationId": "post_api_factor", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/feedback": {"post": {"summary": "POST /api/feedback", "operationId": "post_api_feedback", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/fees": {"get": {"summary": "Fees (config/fees.yaml)", "operationId": "get_api_fees", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/fields": {"get": {"summary": "Fields: 7 bottlenecks by 7 technologies, 49 cells, each live or next", "operationId": "get_api_fields", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/forecasts": {"get": {"summary": "The forecast ledger's rows, Knos's picks with them (docs/reference/forecast_plan_v2.md)", "operationId": "get_api_forecasts", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/front": {"get": {"summary": "Research products open for backing now (the front door's list; ?slug= one product)", "operationId": "get_api_front", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "slug", "in": "query", "required": false, "schema": {"type": "string"}, "x-example-from": {"method": "GET", "path": "/api/front", "pick": "products.0.slug"}}]}}, "/api/fund": {"post": {"summary": "Fund a milestone", "operationId": "post_api_fund", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/lend/advance": {"post": {"summary": "POST /api/lend/advance", "operationId": "post_api_lend_advance", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/lend/collect": {"post": {"summary": "POST /api/lend/collect", "operationId": "post_api_lend_collect", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/lend/quote": {"post": {"summary": "POST /api/lend/quote", "operationId": "post_api_lend_quote", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/maker/claim": {"post": {"summary": "POST /api/maker/claim", "operationId": "post_api_maker_claim", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/maker/confirm": {"post": {"summary": "POST /api/maker/confirm", "operationId": "post_api_maker_confirm", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/maker/publish": {"post": {"summary": "POST /api/maker/publish", "operationId": "post_api_maker_publish", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/maker/search": {"post": {"summary": "POST /api/maker/search", "operationId": "post_api_maker_search", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/maker/start": {"post": {"summary": "POST /api/maker/start", "operationId": "post_api_maker_start", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/match": {"get": {"summary": "The products Qloo matched to a recorded idea (?idea=), for the step that asks whether this is what you mean", "operationId": "get_api_match", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/memory/search": {"get": {"summary": "Search the agent's memory", "operationId": "get_api_memory_search", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string"}, "example": "kombucha"}]}}, "/api/milestone": {"post": {"summary": "Post milestone evidence; 2 of 3 referees release", "operationId": "post_api_milestone", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/money": {"get": {"summary": "The money page: what is held, released and charged, and the price list", "operationId": "get_api_money", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/ai": {"post": {"summary": "NEAR AI Cloud: the reviewer's budget and attestation (free reads, no model call)", "operationId": "post_api_near_ai", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}, "get": {"summary": "The AI reviewer on NEAR AI Cloud: on or off, its model, dollars spent of its $10 and where that figure comes from, its limits, and the model's attestation report hash", "operationId": "get_api_near_ai", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/ai/ledger": {"get": {"summary": "The NEAR AI spend ledger and cached model answers (no key), which a scheduled job saves on the gh-pages branch", "operationId": "get_api_near_ai_ledger", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/balances": {"get": {"summary": "The NEAR testnet accounts that keep the live demo up, each balance against its floor (near/balances.json), read from NEAR", "operationId": "get_api_near_balances", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/claim/cap": {"post": {"summary": "NEAR testnet: agent B's over-budget step, refused by the contract", "operationId": "post_api_near_claim_cap", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/code": {"get": {"summary": "The verified code of the sample claim: the version that passed its locked test on NEAR testnet, as visitor_counter.py, its sha256 in X-Sha256", "operationId": "get_api_near_claim_code", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/claim/counters": {"get": {"summary": "Counters of NEAR testnet's public record: transfers into Knos's fee account (proofs; many came from Knos's own test account, so money moved between Knos's own accounts), the test dollars moved with them, and transfers lost. Jobs paid to agents are in /api/near/totals", "operationId": "get_api_near_claim_counters", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/claim/finish": {"post": {"summary": "NEAR testnet: the claim flow's last steps", "operationId": "post_api_near_claim_finish", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/flow": {"post": {"summary": "NEAR testnet: the claim flow in one call", "operationId": "post_api_near_claim_flow", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/look": {"post": {"summary": "NEAR testnet: a pasted paper link, its claim and its market's price", "operationId": "post_api_near_claim_look", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/pay": {"post": {"summary": "NEAR testnet: the test money behind a claim, split 9 to 1 by the contract's rule", "operationId": "post_api_near_claim_pay", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/plain": {"get": {"summary": "The plain-words page about the sample paper, written by a small model in GitHub Actions (its check run), held by the server", "operationId": "get_api_near_claim_plain", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/claim/prove": {"post": {"summary": "NEAR testnet: the proof of a claim (the locked test, reruns, the verdict, the market settled)", "operationId": "post_api_near_claim_prove", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/quote": {"post": {"summary": "NEAR testnet: a dry quote for the test money that funds a job's test", "operationId": "post_api_near_claim_quote", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/receipt": {"post": {"summary": "NEAR testnet: the receipt after the result, each step with its transaction", "operationId": "post_api_near_claim_receipt", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/reuse": {"post": {"summary": "NEAR testnet: a second proof of the same order, reusing the first one's verified result", "operationId": "post_api_near_claim_reuse", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/run": {"post": {"summary": "NEAR testnet: one claim start to end (market, a test-money Yes, both agents, the release, the settle)", "operationId": "post_api_near_claim_run", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/settle": {"post": {"summary": "NEAR testnet: the claim's market settled from its job", "operationId": "post_api_near_claim_settle", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/claim/try": {"get": {"summary": "The verified code at work: it counts n different visitors (?n=, 1,000 to 100,000) and says how close it came and how many bytes it keeps", "operationId": "get_api_near_claim_try", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/claims": {"get": {"summary": "Every claim Knos can prove, with its truth market and its demand market on NEAR testnet (price before the result, trader count) and the test USDC put behind it", "operationId": "get_api_near_claims", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/guard": {"post": {"summary": "NEAR testnet: the two guardrails, live (over the cap, then no passing work)", "operationId": "post_api_near_guard", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/live": {"post": {"summary": "NEAR testnet: one live job for a visitor, within its caps", "operationId": "post_api_near_live", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}, "get": {"summary": "The live NEAR testnet job for a visitor of /near/: on or off, runs used today, the cap, the bid (POST starts one)", "operationId": "get_api_near_live", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/live/{run}": {"get": {"summary": "One live NEAR job: its step, then who was paid and every testnet transaction", "operationId": "get_api_near_live_run", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "run", "in": "path", "required": true, "schema": {"type": "string"}}]}}, "/api/near/market": {"get": {"summary": "The claim markets on NEAR testnet: the open claim's Yes and No prices in cents, the settled claim's record (POST /api/near/market/buy buys $1 of Yes or No)", "operationId": "get_api_near_market", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/market/buy": {"post": {"summary": "NEAR testnet: one test-money buy of Yes or No on the open claim", "operationId": "post_api_near_market_buy", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/product/buy": {"post": {"summary": "NEAR testnet: buy the job's product with test money, sent to the agent whose code passed", "operationId": "post_api_near_product_buy", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/near/tests": {"get": {"summary": "The full test suite's latest finished run on main (GitHub Actions): passed or not, and its link", "operationId": "get_api_near_tests", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/near/totals": {"get": {"summary": "The NEAR jobs contract's totals: since_upgrade holds jobs paid to agents and test USDC paid out since its 14 Nov upgrade, read from the contract (get_totals, get_agent_record); paid_usd, jobs_paid and tries are an older walk of its public record, with read_at", "operationId": "get_api_near_totals", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/open-signals": {"post": {"summary": "Demand from open signals only (no Qloo, keyless)", "operationId": "post_api_open-signals", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"idea": {"type": "string"}, "place": {"type": "string"}}}, "example": {"idea": "a cold brew coffee shop", "place": "Austin"}}}}}}, "/api/ops/memory": {"get": {"summary": "The operator's: this process's memory now and at its peak", "operationId": "get_api_ops_memory", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/outside": {"get": {"summary": "The outside counter: crossings and pre-order commitments by people outside Knos, summed from the store", "operationId": "get_api_outside", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/outside/rows": {"get": {"summary": "Every row the outside counter sums (kind, time, crossing id or order address, via)", "operationId": "get_api_outside_rows", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/pay": {"post": {"summary": "Record a test payment for a browser ({browser, press}): 20 more runs; a repeated press records nothing more, and a different payload on the same press is refused (409)", "operationId": "post_api_pay", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/pay/fund": {"get": {"summary": "Solana Pay transaction request: the label and icon a wallet shows before funding a milestone", "operationId": "get_api_pay_fund", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}, "post": {"summary": "Solana Pay transaction request: {account} -> the milestone's funding transaction to sign", "operationId": "post_api_pay_fund", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "units": {"type": "integer"}, "account": {"type": "string"}}}}}}}}, "/api/pool": {"get": {"summary": "A report's pre-order pool", "operationId": "get_api_pool", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "hash", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff051897a9799ed592e7a6875bce6559c1c19fa67b0be41899c0"}]}}, "/api/preorder": {"post": {"summary": "Pre-order, held until the milestone check passes", "operationId": "post_api_preorder", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/preorder/demo": {"post": {"summary": "POST /api/preorder/demo", "operationId": "post_api_preorder_demo", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/preorder/faucet": {"post": {"summary": "POST /api/preorder/faucet", "operationId": "post_api_preorder_faucet", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/preorder/submit": {"post": {"summary": "POST /api/preorder/submit", "operationId": "post_api_preorder_submit", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/preorder/tx": {"post": {"summary": "POST /api/preorder/tx", "operationId": "post_api_preorder_tx", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/presence": {"post": {"summary": "Your pointer on a project page, and everyone else's there now (live cursors)", "operationId": "post_api_presence", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"page": {"type": "string"}, "me": {"type": "string"}, "x": {"type": "string"}, "y": {"type": "string"}, "label": {"type": "string"}}}}}}}}, "/api/price": {"get": {"summary": "A Pyth price (EUR/USD, GBP/USD, SOL/USD, BTC/USD, ETH/USD, USDC/USD), for a milestone in another currency", "operationId": "get_api_price", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "pair", "in": "query", "required": false, "schema": {"type": "string"}, "example": "EUR/USD"}]}}, "/api/prize/evidence": {"get": {"summary": "A demo prize's public evidence (the round's verdict)", "operationId": "get_api_prize_evidence", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "x-example-from": {"method": "GET", "path": "/api/tasks", "pick": "rounds.0.prize.id"}}]}}, "/api/products": {"get": {"summary": "Listed products", "operationId": "get_api_products", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/progress": {"get": {"summary": "One running check: its live Qloo calls and entities so far (?req=)", "operationId": "get_api_progress", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/project": {"get": {"summary": "One project with its milestones, orders, attempts and routing", "operationId": "get_api_project", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "example": "7b4ed16b8c2903dc"}]}, "post": {"summary": "Open a project from a template (+ regulatory sets); deadline_s for a one-day sandbox", "operationId": "post_api_project", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"template": {"type": "string"}, "title": {"type": "string"}, "regulatory": {"type": "array", "items": {}}, "report": {"type": "string"}, "team": {"type": "string"}, "deadline_s": {"type": "integer"}}}}}}}}, "/api/project/amc": {"post": {"summary": "Advance-market commitment: an allowance collected only when the milestone verifies (passkey=true: your passkey approves it)", "operationId": "post_api_project_amc", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "units": {"type": "integer"}, "account": {"type": "string"}, "passkey": {"type": "boolean"}}}}}}}}, "/api/project/amc/confirm": {"post": {"summary": "Mark an AMC allowance approved once it is on devnet", "operationId": "post_api_project_amc_confirm", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"amc": {"type": "string"}, "signature": {"type": "string"}}}}}}}}, "/api/project/archive": {"post": {"summary": "Take a project off the public list (still readable by id): its buyer, signed in, or the operator's X-Knos-Admin key", "operationId": "post_api_project_archive", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "why": {"type": "string"}}}}}}}}, "/api/project/brief": {"post": {"summary": "The buyer edits a project's brief (until money locks)", "operationId": "post_api_project_brief", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "brief": {"type": "object"}}}}}}}}, "/api/project/cancel": {"post": {"summary": "The buyer cancels: the maker keeps the kill fee agreed before lock", "operationId": "post_api_project_cancel", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}}}}}}}}, "/api/project/change": {"post": {"summary": "After lock: the buyer proposes a change request (a new criteria hash)", "operationId": "post_api_project_change", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "brief": {"type": "object"}, "why": {"type": "string"}}}}}}}}, "/api/project/change/decide": {"post": {"summary": "The maker accepts or rejects a change request", "operationId": "post_api_project_change_decide", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "change": {"type": "string"}, "accept": {"type": "boolean"}}}}}}}}, "/api/project/ci": {"post": {"summary": "Release a milestone whose check passed in CI: GitHub's record of the commit decides it", "operationId": "post_api_project_ci", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "sha": {"type": "string"}}}}}}}}, "/api/project/claim": {"post": {"summary": "A maker attempts a milestone and binds its payee wallet (passkey=true: paid to your passkey wallet)", "operationId": "post_api_project_claim", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "wallet": {"type": "string"}, "passkey": {"type": "boolean"}}}}}}}}, "/api/project/confirm": {"post": {"summary": "Mark a funding locked once its order is on devnet", "operationId": "post_api_project_confirm", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"order": {"type": "string"}, "signature": {"type": "string"}}}}}}}}, "/api/project/dispute": {"post": {"summary": "Dispute a referee verdict inside its challenge window, with evidence", "operationId": "post_api_project_dispute", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "attempt": {"type": "string"}, "url": {"type": "string"}}}}}}}}, "/api/project/evidence": {"get": {"summary": "A project attempt's public review (both pages and the claim ids)", "operationId": "get_api_project_evidence", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "x-example-from": {"method": "GET", "path": "/api/project?id=7b4ed16b8c2903dc", "pick": "milestones.0.attempts.0.evidence"}}]}}, "/api/project/fund": {"post": {"summary": "Fund one milestone (funder, grant or pool): the devnet transaction a wallet signs, or with passkey=true the step your passkey approves", "operationId": "post_api_project_fund", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "units": {"type": "integer"}, "account": {"type": "string"}, "kind": {"type": "string"}, "grant": {"type": "object"}, "ref": {"type": "string"}, "pool": {"type": "string"}, "passkey": {"type": "boolean"}}}}}}}}, "/api/project/operator": {"post": {"summary": "The operator (X-Knos-Admin): open a project bound to a GitHub repository from a Ready brief, fund a milestone from the app's devnet test wallet, or claim it for CI", "operationId": "post_api_project_operator", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"action": {"type": "string"}, "brief": {"type": "object"}, "title": {"type": "string"}, "repo": {"type": "string"}, "project": {"type": "string"}, "milestone": {"type": "string"}, "units": {"type": "integer"}, "wallet": {"type": "string"}}}}}}}}, "/api/project/pool": {"post": {"summary": "Megafund: one funder spreads units over 2-8 milestones (one transaction each)", "operationId": "post_api_project_pool", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"allocations": {"type": "array", "items": {}}, "units": {"type": "integer"}, "account": {"type": "string"}, "ref": {"type": "string"}}}}}}}}, "/api/project/post": {"post": {"summary": "Post a result (the maker) or an independent check (someone else, another site)", "operationId": "post_api_project_post", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "attempt": {"type": "string"}, "url": {"type": "string"}, "role": {"type": "string"}}}}}}}}, "/api/project/private": {"post": {"summary": "A private order's encrypted amount and its ZK ElGamal proofs, verified on devnet", "operationId": "post_api_project_private", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"order": {"type": "string"}, "ciphertext": {"type": "string"}, "pubkey_proof": {"type": "string"}, "range_proof": {"type": "string"}}}}}}}}, "/api/project/prompt": {"get": {"summary": "What an agent working on a milestone is handed: the locked intent, effort and budget", "operationId": "get_api_project_prompt", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "project", "in": "query", "required": true, "schema": {"type": "string"}, "example": "7b4ed16b8c2903dc"}, {"name": "milestone", "in": "query", "required": true, "schema": {"type": "string"}, "example": "preorders"}]}}, "/api/project/route": {"get": {"summary": "Where a milestone's work can be bought (labs, knos.game) and its quotes", "operationId": "get_api_project_route", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "project", "in": "query", "required": true, "schema": {"type": "string"}, "example": "7b4ed16b8c2903dc"}, {"name": "milestone", "in": "query", "required": true, "schema": {"type": "string"}, "example": "preorders"}]}}, "/api/project/solve": {"post": {"summary": "A referee-checked milestone (knos-referee:<round>): claim it if needed, submit code to its round, released on a passing verdict (an agent key or its OAuth token is enough)", "operationId": "post_api_project_solve", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"project": {"type": "string"}, "milestone": {"type": "string"}, "code": {"type": "string"}, "wallet": {"type": "string"}}}}}}}}, "/api/project/sweep": {"post": {"summary": "Run the deadline sweeper now (it also runs every minute)", "operationId": "post_api_project_sweep", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/projects": {"get": {"summary": "Projects, newest first", "operationId": "get_api_projects", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "take", "in": "query", "required": false, "schema": {"type": "integer"}, "example": 10}]}}, "/api/proof": {"get": {"summary": "The latest real verdict this server reached (shown first on both front doors)", "operationId": "get_api_proof", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/proofs": {"get": {"summary": "Recorded infrastructure proofs (kind + Helm, Keycloak SSO, Odoo/ERPNext/hledger imports, Sigstore), cosign-signed", "operationId": "get_api_proofs", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/proofs/cosign.pub": {"get": {"summary": "The public key that signed /api/proofs", "operationId": "get_api_proofs_cosign.pub", "responses": {"200": {"description": "OK", "content": {"text/plain": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/proofs/signature": {"get": {"summary": "The cosign (Sigstore bundle) signature of /api/proofs", "operationId": "get_api_proofs_signature", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/qloo-diff": {"post": {"summary": "POST /api/qloo-diff", "operationId": "post_api_qloo-diff", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}, "get": {"summary": "The \"With and without Qloo\" table: 20 ideas, each checked with Qloo and with the key unset", "operationId": "get_api_qloo-diff", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/qloo/status": {"get": {"summary": "The same as JSON, with the line the front door shows while Qloo limits requests", "operationId": "get_api_qloo_status", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/quote": {"get": {"summary": "Fee quote", "operationId": "get_api_quote", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "hash", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff051897a9799ed592e7a6875bce6559c1c19fa67b0be41899c0"}, {"name": "units", "in": "query", "required": false, "schema": {"type": "integer"}, "example": 5}]}}, "/api/ready": {"post": {"summary": "Ready to fund: is a brief clear enough to lock money on (free; nothing stored)", "operationId": "post_api_ready", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"brief": {"type": "object"}}}, "example": {"brief": {"title": "A check", "milestones": [{"name": "Tests pass", "target": "pytest exits 0 on the repository", "verifier": {"kind": "machine", "check": "pytest"}, "deadline_days": 3}]}}}}}}, "get": {"summary": "How to ask for a Ready check (it is a POST)", "operationId": "get_api_ready", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/ready/card": {"post": {"summary": "Attest a Ready brief on devnet: the shareable card", "operationId": "post_api_ready_card", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}, "get": {"summary": "A Ready card, read back from its devnet attestation (?hash= the criteria hash)", "operationId": "get_api_ready_card", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "hash", "in": "query", "required": true, "schema": {"type": "string"}, "example": "0000000000000000000000000000000000000000000000000000000000000000"}]}}, "/api/ready/resolve": {"post": {"summary": "Keep the reading a buyer tapped for a vague word (offered first next time)", "operationId": "post_api_ready_resolve", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"word": {"type": "string"}, "reading": {"type": "string"}, "target": {"type": "string"}}}}}}}}, "/api/receipts": {"get": {"summary": "A result's receipts (?id=, the first 16 hex of its hash): each Qloo call with its time and hash, the target's rule, the model's answer, the brief's criteria hash, the Knos record line, devnet transactions", "operationId": "get_api_receipts", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff05"}]}}, "/api/receivables": {"get": {"summary": "Receivables a lender can finance (passkey wallets: advance rate, fee, due date)", "operationId": "get_api_receivables", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "take", "in": "query", "required": false, "schema": {"type": "integer"}, "example": 5}]}}, "/api/record/head": {"get": {"summary": "The Knos record's newest line: its sequence number, time and kind", "operationId": "get_api_record_head", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/recorded": {"get": {"summary": "The recorded answer for an idea, word for word (never a live check)", "operationId": "get_api_recorded", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/referee/attest": {"post": {"summary": "A referee host's FROST round: its attestation (signed by its transport key)", "operationId": "post_api_referee_attest", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/referee/commit": {"post": {"summary": "A referee host's FROST round: its commitment (signed by its transport key)", "operationId": "post_api_referee_commit", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/referee/group": {"get": {"summary": "The FROST referee group (public)", "operationId": "get_api_referee_group", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/referee/pending": {"get": {"summary": "Open referee signing sessions", "operationId": "get_api_referee_pending", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/referee/session": {"get": {"summary": "One referee signing session", "operationId": "get_api_referee_session", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "query", "required": true, "schema": {"type": "string"}, "x-example-from": {"method": "GET", "path": "/api/referee/pending", "pick": "sessions.0.id"}}]}}, "/api/referee/share": {"post": {"summary": "A referee host's FROST round: its signature share (signed by its transport key)", "operationId": "post_api_referee_share", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/referral": {"post": {"summary": "A referral link; the referrer's share is a knos_pay payee on release (passkey=true: paid to your passkey wallet)", "operationId": "post_api_referral", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"target": {"type": "string"}, "wallet": {"type": "string"}, "passkey": {"type": "boolean"}}}}}}}}, "/api/refund": {"post": {"summary": "Refund past the deadline", "operationId": "post_api_refund", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/refuse": {"get": {"summary": "What Knos will not fund: the refuse list the Ready check applies", "operationId": "get_api_refuse", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/report": {"get": {"summary": "A demand report", "operationId": "get_api_report", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "hash", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff051897a9799ed592e7a6875bce6559c1c19fa67b0be41899c0"}]}}, "/api/research": {"post": {"summary": "Research card from a paper id", "operationId": "post_api_research", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"ref": {"type": "string"}, "product": {"type": "string"}}}, "example": {"ref": "10.1038/nature14539"}}}}}}, "/api/run": {"post": {"summary": "Run a tool on a list ({id, input, mode, browser, test}): the result line, the exact count, the result's link, runs left; 402 past the free runs, 413 over the line limit, 408 over the time limit", "operationId": "post_api_run", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/sandbox": {"post": {"summary": "A one-day devnet sandbox project from a template", "operationId": "post_api_sandbox", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"template": {"type": "string"}, "title": {"type": "string"}, "team": {"type": "string"}}}}}}}}, "/api/sign": {"post": {"summary": "POST /api/sign", "operationId": "post_api_sign", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/sns": {"get": {"summary": "Who owns a .sol name on this cluster (Name Service), for a project that names one", "operationId": "get_api_sns", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "name", "in": "query", "required": true, "schema": {"type": "string"}, "example": "knos.sol"}]}}, "/api/solvers": {"get": {"summary": "Proven solvers first: wallets by verified milestones, each read back from devnet", "operationId": "get_api_solvers", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/sso/config": {"get": {"summary": "Whether SAML single sign-on (SAML Jackson) is on", "operationId": "get_api_sso_config", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/status": {"get": {"summary": "Server status", "operationId": "get_api_status", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/task/submit": {"post": {"summary": "Submit to a contributor round", "operationId": "post_api_task_submit", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/tasks": {"get": {"summary": "Open contributor rounds (knos.game)", "operationId": "get_api_tasks", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/taste/movie": {"get": {"summary": "The films a film's fans also love, from Qloo (?title=&year=): names and years only", "operationId": "get_api_taste_movie", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "503": {"description": "Qloo did not answer, with the reason in `error`"}}, "x-read-only": true, "parameters": [{"name": "title", "in": "query", "required": true, "schema": {"type": "string"}, "example": "Inception"}, {"name": "year", "in": "query", "required": true, "schema": {"type": "integer"}, "example": 2010}]}}, "/api/templates": {"get": {"summary": "Milestone templates and OpenRegulatory regulatory sets", "operationId": "get_api_templates", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/test/record": {"post": {"summary": "POST /api/test/record", "operationId": "post_api_test_record", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/tools": {"get": {"summary": "The tools a person can run: id, title and sample of each", "operationId": "get_api_tools", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/trace": {"get": {"summary": "A demand report's Qloo calls, redacted: endpoint, params, ids, excerpt, limit", "operationId": "get_api_trace", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "hash", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff051897a9799ed592e7a6875bce6559c1c19fa67b0be41899c0"}]}}, "/api/trace/keep": {"post": {"summary": "POST /api/trace/keep", "operationId": "post_api_trace_keep", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/track": {"get": {"summary": "A wallet's track record: its Solana Attestation Service attestations of verified milestones", "operationId": "get_api_track", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "wallet", "in": "query", "required": true, "schema": {"type": "string"}, "example": "EZi57B4aT661Nwf9oZyPN5ronZMMgtgGUfe68aGff4Gf"}]}}, "/api/usage": {"get": {"summary": "Demand checks run, Ready briefs made, the knos_pay program's devnet transactions, and the tools' per-day counts (days, test_days) and three measures", "operationId": "get_api_usage", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/vectors": {"get": {"summary": "The seven product-value vectors, measured: cost, speed, friction, trust, capability, access, status", "operationId": "get_api_vectors", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/visit": {"post": {"summary": "One first-party event of an anonymous visit (no cookie, no IP stored)", "operationId": "post_api_visit", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/api/visits": {"get": {"summary": "The first-party funnel of the last 7 days (visits, first press, first result, proof finished, backed, came back) and the screen people leave from most; no cookie, IP or account is stored", "operationId": "get_api_visits", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/api/wallet": {"post": {"summary": "POST /api/wallet", "operationId": "post_api_wallet", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/wallet/faucet": {"post": {"summary": "POST /api/wallet/faucet", "operationId": "post_api_wallet_faucet", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "401": {"description": "sign in first"}}, "security": [{"session": []}]}}, "/api/x402/report": {"get": {"summary": "A demand report, paid per read over x402", "operationId": "get_api_x402_report", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}, "402": {"description": "payment required: the x402 price, in the PAYMENT-REQUIRED header"}}, "x-read-only": true, "parameters": [{"name": "hash", "in": "query", "required": true, "schema": {"type": "string"}, "example": "14d68eb782caff051897a9799ed592e7a6875bce6559c1c19fa67b0be41899c0"}]}}, "/app": {"get": {"summary": "301 to /app/", "operationId": "get_app", "responses": {"301": {"description": "moved: /app/", "headers": {"Location": {"schema": {"type": "string"}, "example": "/app/"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/app/": {"get": {"summary": "The app", "operationId": "get_app_page", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/auth/orcid": {"get": {"summary": "Sign in with ORCID", "operationId": "get_auth_orcid", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/auth/orcid/callback": {"get": {"summary": "ORCID callback", "operationId": "get_auth_orcid_callback", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/auth/sso": {"get": {"summary": "Start SAML sign-in through SAML Jackson", "operationId": "get_auth_sso", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "parameters": [{"name": "tenant", "in": "query", "required": false, "schema": {"type": "string"}}]}}, "/auth/sso/acs": {"post": {"summary": "A test IdP's signed SAML answer (Knos as the service provider; HTTP-POST binding)", "operationId": "post_auth_sso_acs", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"SAMLResponse": {"type": "string"}, "RelayState": {"type": "string"}}}}}}}}, "/auth/sso/callback": {"get": {"summary": "SAML Jackson's OAuth callback", "operationId": "get_auth_sso_callback", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "parameters": [{"name": "code", "in": "query", "required": false, "schema": {"type": "string"}}, {"name": "state", "in": "query", "required": false, "schema": {"type": "string"}}]}}, "/auth/sso/metadata": {"get": {"summary": "Knos's SAML service-provider metadata (entity id, ACS)", "operationId": "get_auth_sso_metadata", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/companies": {"get": {"summary": "Companies", "operationId": "get_companies", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/fields": {"get": {"summary": "Fields", "operationId": "get_fields", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/healthz": {"get": {"summary": "Health check", "operationId": "get_healthz", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/llms.txt": {"get": {"summary": "This app for language models (llmstxt.org)", "operationId": "get_llms.txt", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/manifest.webmanifest": {"get": {"summary": "The app's web app manifest (installable, home-screen shortcuts)", "operationId": "get_manifest.webmanifest", "responses": {"200": {"description": "OK", "content": {"application/manifest+json": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/mcp": {"get": {"summary": "MCP discovery page (POST JSON-RPC here)", "operationId": "get_mcp", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}, "post": {"summary": "Hosted MCP (Streamable HTTP, JSON-RPC 2.0): Knos's tools for agents", "operationId": "post_mcp", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/mcp/server-card": {"get": {"summary": "The MCP Server Card (SEP-2127): the /mcp remote and its protocol versions", "operationId": "get_mcp_server-card", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/mcp/store": {"get": {"summary": "The app-store MCP profile: read-only tools, no sign-in, a daily call cap (POST JSON-RPC here)", "operationId": "get_mcp_store", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/money": {"get": {"summary": "The money", "operationId": "get_money", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/oauth/token": {"post": {"summary": "OAuth 2.0 token (RFC 6749 4.4, client credentials): an agent key's id and secret -> a one-hour Bearer token", "operationId": "post_oauth_token", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}}}, "/og/r/{id}.png": {"get": {"summary": "A result's 1200 x 630 link image", "operationId": "get_og_r_id.png", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}]}}, "/og/t/{id}.png": {"get": {"summary": "A tool's 1200 x 630 link image", "operationId": "get_og_t_id.png", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}]}}, "/openapi.json": {"get": {"summary": "This document", "operationId": "get_openapi.json", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/paid": {"get": {"summary": "301 to /app/?all=1: the app with the passkey wallet, pre-orders, pools, company sign-in and accounting files", "operationId": "get_paid", "responses": {"301": {"description": "moved: /app/?all=1", "headers": {"Location": {"schema": {"type": "string"}, "example": "/app/?all=1"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/quality": {"get": {"summary": "301 to the front door", "operationId": "get_quality", "responses": {"301": {"description": "moved: https://drexthealpha.github.io/Knos/", "headers": {"Location": {"schema": {"type": "string"}, "example": "https://drexthealpha.github.io/Knos/"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/quality/": {"get": {"summary": "301 to the front door", "operationId": "get_quality_page", "responses": {"301": {"description": "moved: https://drexthealpha.github.io/Knos/", "headers": {"Location": {"schema": {"type": "string"}, "example": "https://drexthealpha.github.io/Knos/"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/r/{code}": {"get": {"summary": "Follow a referral link", "operationId": "get_r_code", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}}]}}, "/r/{id}/": {"get": {"summary": "One run's result page: that input and that result", "operationId": "get_r_id_page", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}]}}, "/robots.txt": {"get": {"summary": "Crawler rules: search and assistant bots allowed, /api/ left out", "operationId": "get_robots.txt", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/sitemap.xml": {"get": {"summary": "The public pages and traces, with lastmod", "operationId": "get_sitemap.xml", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/start": {"get": {"summary": "301 to the front door", "operationId": "get_start", "responses": {"301": {"description": "moved: https://drexthealpha.github.io/Knos/", "headers": {"Location": {"schema": {"type": "string"}, "example": "https://drexthealpha.github.io/Knos/"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/start/": {"get": {"summary": "301 to the front door", "operationId": "get_start_page", "responses": {"301": {"description": "moved: https://drexthealpha.github.io/Knos/", "headers": {"Location": {"schema": {"type": "string"}, "example": "https://drexthealpha.github.io/Knos/"}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/status/qloo": {"get": {"summary": "Qloo as this server met it today: calls, cache hits, last success, last 429", "operationId": "get_status_qloo", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/sw.js": {"get": {"summary": "The app's service worker (offline shell, background sync)", "operationId": "get_sw.js", "responses": {"200": {"description": "OK", "content": {"application/javascript": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/t/{id}/": {"get": {"summary": "A tool's page, its og tags in the first response", "operationId": "get_t_id_page", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true, "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "string"}}]}}, "/trace": {"get": {"summary": "A demand report trace page (?hash=), its verdict in the HTML", "operationId": "get_trace", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/trace.md": {"get": {"summary": "A demand report trace as Markdown (?hash=)", "operationId": "get_trace.md", "responses": {"200": {"description": "OK", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/verify": {"get": {"summary": "How we verify", "operationId": "get_verify", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}, "/with-without": {"get": {"summary": "With and without Qloo: the 20 ideas, the table in the page", "operationId": "get_with-without", "responses": {"200": {"description": "an HTML page", "content": {"text/html": {"schema": {"type": "string"}}}}, "400": {"description": "refused, with the reason in `error`"}, "404": {"description": "no such object, with the reason in `error`"}, "429": {"description": "rate limited"}}, "x-read-only": true}}}}