Openapi Json | LoreOS

curl https://api.loreos.app/v1/openapi.json \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json"

{
  "openapi": "3.1.0",
  "info": {
    "title": "LoreOS API",
    "description": "LoreOS is a managed character-chat runtime — \"Stripe for character chat\". Provision an app, then create characters and run chat sessions over a simple REST API. Every endpoint under `/v1` is scoped to your app by your API key. See `/v1/describe` for a machine-readable catalog and `/v1/llms.txt` for an agent-friendly guide.",
    "version": "0.1.0"
  },
  "paths": {
    "/v1/openapi.json": {
      "get": {
        "tags": [
          "v1"
        ],
        "summary": "Openapi Json",
        "description": "The PUBLIC /v1-only OpenAPI schema (auth-free). The app's raw ``/openapi.json`` is served\nfrom one process with the internal ``/admin`` + ``/cbt`` surface; this returns ONLY the public\n``/v1`` ops (the supported API). Point your SDK generator / coding agent here, not at the raw\n``/openapi.json``.",
        "operationId": "v1_openapi_json_v1_openapi_json_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": true,
                  "type": "object",
                  "title": "Response V1 Openapi Json V1 Openapi Json Get"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.loreos.app",
      "description": "Production"
    },
    {
      "url": "http://127.0.0.1:8000",
      "description": "Local development"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "LoreOS API key, sent as `Authorization: Bearer <key>`."
      }
    }
  }
}

The PUBLIC /v1-only OpenAPI schema (auth-free). The app’s raw /openapi.json is served from one process with the internal /admin + /cbt surface; this returns ONLY the public /v1 ops (the supported API). Point your SDK generator / coding agent here, not at the raw /openapi.json.

Authentication

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

Response

Successful Response

1	{
2	"openapi": "3.1.0",
3	"info": {
4	"title": "LoreOS API",
5	"description": "LoreOS is a managed character-chat runtime — \"Stripe for character chat\". Provision an app, then create characters and run chat sessions over a simple REST API. Every endpoint under `/v1` is scoped to your app by your API key. See `/v1/describe` for a machine-readable catalog and `/v1/llms.txt` for an agent-friendly guide.",
6	"version": "0.1.0"
7	},
8	"paths": {
9	"/v1/openapi.json": {
10	"get": {
11	"tags": [
12	"v1"
13	],
14	"summary": "Openapi Json",
15	"description": "The PUBLIC /v1-only OpenAPI schema (auth-free). The app's raw ``/openapi.json`` is served\nfrom one process with the internal ``/admin`` + ``/cbt`` surface; this returns ONLY the public\n``/v1`` ops (the supported API). Point your SDK generator / coding agent here, not at the raw\n``/openapi.json``.",
16	"operationId": "v1_openapi_json_v1_openapi_json_get",
17	"responses": {
18	"200": {
19	"description": "Successful Response",
20	"content": {
21	"application/json": {
22	"schema": {
23	"additionalProperties": true,
24	"type": "object",
25	"title": "Response V1 Openapi Json V1 Openapi Json Get"
26	}
27	}
28	}
29	}
30	}
31	}
32	}
33	},
34	"servers": [
35	{
36	"url": "https://api.loreos.app",
37	"description": "Production"
38	},
39	{
40	"url": "http://127.0.0.1:8000",
41	"description": "Local development"
42	}
43	],
44	"security": [
45	{
46	"ApiKeyAuth": []
47	}
48	],
49	"components": {
50	"securitySchemes": {
51	"ApiKeyAuth": {
52	"type": "http",
53	"scheme": "bearer",
54	"description": "LoreOS API key, sent as `Authorization: Bearer <key>`."
55	}
56	}
57	}
58	}