This page indexes every machine-readable surface Sozee publishes, for developers and AI agents integrating with Sozee or consuming the Sozee Resources library programmatically.
Sozee discovery endpoints
- /resources/llms.txt — site overview and agent guidance (when to use Sozee, URL patterns, contact). A fuller index lives at /resources/llms-full.txt.
- /resources/.well-known/agent-card.json — A2A agent card describing the Sozee content agent.
- /resources/.well-known/ai-plugin.json — AI plugin manifest.
- /resources/sitemap.xml — sitemap index for the full guide library.
Sozee Content API
The guide library is readable over a public, no-auth JSON API (the WordPress REST surface). The OpenAPI 3.0 specification lives at /resources/openapi.json and documents every operation: listPosts, getPost, listCategories, listTags and searchContent. Errors return structured JSON (code, message, data.status) — never HTML error pages. Read-only: there is no write access and no API for the Sozee product itself.
Stability & deprecation policy
The content API is versioned in the URL (wp/v2) and treated as stable. Rate limits are declared per response via RateLimit-Limit / RateLimit-Policy headers (60 requests per minute). Any breaking change will ship under a new version path, with the old version answering Deprecation and Sunset headers for at least 90 days before removal, and the change announced on this page.
Content access for AI agents
- Server-rendered HTML: every page is fully readable without JavaScript, with JSON-LD identity and collection schema on the index.
- Markdown negotiation: request any guide with an
Accept: text/markdownheader to receive a markdown rendition. - URL patterns: guides at
/resources/{slug}/, topic hubs at/resources/category/{category}/and/resources/tag/{tag}/.
The Sozee product
Sozee itself — the AI content studio at sozee.ai — is a human-operated product: agents should hand a user off to app.sozee.ai rather than attempt automated signup. For integration or partnership inquiries, see the contact page.