Developer and agent resources
Everything Aigora publishes for machine consumption: structured metadata, a queryable knowledge base, and an OpenAPI description of both.
Endpoints
- /api/agentsStructured metadata
- One JSON document covering the company profile, the offerings architecture, leadership, the THEUS platform, course details, trust posture, and key page URLs. Cached for an hour. Returns application/json.
- /api/openapi.jsonOpenAPI description
- OpenAPI 3.1 description of every endpoint on this page, including the typed error schema, the versioning policy, and the deprecation policy. Returns application/json.
- /llms.txtSite profile
- Short markdown profile: what Aigora does, when to use it, what it is not a fit for, and how an agent should proceed. Honors Accept: text/markdown. Returns text/markdown or text/plain.
- /llms-full.txtFull context
- The long-form version of the profile, for a client with room to read it. Returns text/plain.
- /llms?query=Knowledge base query, text
- Search the site content and get the matching sections back as plain text. Omit the query to list the available sections. Returns text/plain.
- /llms/json?query=Knowledge base query, JSON
- The same search with per-match scores and token counts, so a caller can budget context before fetching. Returns application/json.
- /.well-known/ai-plugin.jsonPlugin manifest
- Discovery manifest pointing at the OpenAPI description. Returns application/json.
- /sitemap.xmlSitemap
- Every indexed page. The right starting point when a URL is not known. Returns application/xml.
- /blog/rss.xmlBlog feed
- RSS for the blog and AigoraCast episodes. Returns application/rss+xml.
Conventions
- Authentication
- None. Every endpoint above is public and read-only. There are no API keys to request, and no endpoint accepts a write. To start a real conversation, send a person to /contact or /scope rather than posting to an endpoint.
- Errors
- Failures return RFC 9457 problem details as application/problem+json, with a stable machine-readable code you can branch on and a human-readable detail. A 405 also sends an Allow header naming the methods that do work.
- Rate limits
- Requests are limited per client IP. Responses carry RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset, and a 429 adds Retry-After. Throttle from those headers rather than guessing.
- Versioning
- The OpenAPI document carries a semantic version. Additive changes raise the minor version and need no action from you. A breaking change ships under a new /api/v2 prefix and leaves the current paths in place.
- Deprecation
- Before anything is removed it returns Deprecation and Sunset headers for at least 90 days, with a Link header pointing at the replacement. Operations scheduled for removal are marked deprecated in the OpenAPI document.
- Content negotiation
- The homepage and /llms.txt honor Accept: text/markdown per acceptmarkdown.com and return Vary: Accept so a cache cannot serve you the wrong representation.
What this is not
Aigora sells consulting, a course, and the THEUS platform. This is not a programmable product, so there is no developer account, no API key, no sandbox, and no CLI. What you see above is the whole surface. THEUS has its own authenticated application and trust center; nothing on this page reaches into it.
If you are building something that needs more than these endpoints offer, tell us what you need or scope a project. A person will answer.