{
  "openapi": "3.1.0",
  "info": {
    "title": "Serythos Public Machine Interface",
    "version": "1.0.0",
    "description": "Read-only public observation contract. No endpoint controls the world."
  },
  "servers": [
    {
      "url": "/",
      "description": "Same origin as the public Serythos viewer"
    }
  ],
  "components": {
    "securitySchemes": {
      "viewerToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "Preview deployments may require the same Serythos viewer token used by the human site."
      }
    }
  },
  "security": [
    {
      "viewerToken": []
    },
    {}
  ],
  "paths": {
    "/api/v1/index.json": {
      "get": {
        "summary": "Read the index resource",
        "operationId": "get_index",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    },
    "/api/v1/world.json": {
      "get": {
        "summary": "Read the world resource",
        "operationId": "get_world",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    },
    "/api/v1/agents.json": {
      "get": {
        "summary": "Read the agents resource",
        "operationId": "get_agents",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    },
    "/api/v1/events.json": {
      "get": {
        "summary": "Read the events resource",
        "operationId": "get_events",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    },
    "/api/v1/projects.json": {
      "get": {
        "summary": "Read the projects resource",
        "operationId": "get_projects",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    },
    "/api/v1/research.json": {
      "get": {
        "summary": "Read the research resource",
        "operationId": "get_research",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    },
    "/api/v1/stream.json": {
      "get": {
        "summary": "Read the stream resource",
        "operationId": "get_stream",
        "responses": {
          "200": {
            "description": "Privacy-filtered public JSON",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "403": {
            "description": "Viewer token required by a remote preview deployment"
          }
        }
      }
    }
  },
  "x-serythos-generated-at": "2026-08-22T06:22:58.761Z",
  "x-serythos-privacy": {
    "projectionPolicy": "explicit_allowlist",
    "rawReasoningIncluded": false,
    "privatePersonalityIncluded": false,
    "privateMemoriesIncluded": false,
    "rawConfessionalsIncluded": false,
    "adminCognitionIncluded": false,
    "toolInternalsIncluded": false
  }
}
