Skip to content

Developer and agent resources

Everything Aigora publishes for machine consumption: structured metadata, a queryable knowledge base, and an OpenAPI description of both.

Endpoints

Structured metadata

/api/agents

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.

OpenAPI description

/api/openapi.json

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.

Site profile

/llms.txt

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.

Full context

/llms-full.txt

The long-form version of the profile, for a client with room to read it. Returns text/plain.

Knowledge base query, text

/llms?query=

Search the site content and get the matching sections back as plain text. Omit the query to list the available sections. Returns text/plain.

Knowledge base query, JSON

/llms/json?query=

The same search with per-match scores and token counts, so a caller can budget context before fetching. Returns application/json.

Plugin manifest

/.well-known/ai-plugin.json

Discovery manifest pointing at the OpenAPI description. Returns application/json.

Sitemap

/sitemap.xml

Every indexed page. The right starting point when a URL is not known. Returns application/xml.

Blog feed

/blog/rss.xml

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 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. Breaking changes raise the major version. General purpose replacement endpoints use a new path prefix when callers need a transition period.

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, training, Theus, and Forethought. 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 nothing on this page reaches into it. Its controls are documented in the Theus trust center.

If you are building something that needs more than these endpoints offer, tell us what you need. A person will answer.