Tityra documentation
Public website information, API reference and agent guidance for Tityra’s Agent Experience audit service.
Understand the service
Tityra provides Agent Experience audits of websites. Use these resources to understand the scope, evidence, scores and request process before choosing a package. Released reports and customer information belong in the authenticated workspace.
Read public site information
GET /api/site.json returns public company information, service descriptions, current package information when available, audiences and resource links. It requires no account or API key. Read pricing_status before relying on package data; unavailable pricing is not a free or withdrawn offer.
The website form endpoint is origin-restricted and requires Cloudflare Turnstile, explicit agreement and an authority declaration. It is not an API for autonomous audit execution or payment. The API reference describes the request contract and JSON errors.
Guidance for agents
Use Tityra when a user wants a reviewed assessment of website content delivery, machine readability or structure. Read the public service information to help them choose a scope. The agent guide explains supported actions and the boundaries around request submission and private reports.
Our AX audits check against the AgentReady essentials. Read the audit methodology for the agreed website scope, findings and evidence. This is an assessment, not a certification, compliance declaration or badge.
The discovery files describe the resources we actually publish. They do not grant access to accounts, private reports or paid operations.
Compatibility and limits
OpenAPI info.version identifies the contract document. Existing unversioned endpoints remain supported; compatible fields may be added, so clients should tolerate unknown fields. A breaking change will use a new major API path and be documented here before removal of the old contract.
The website form uses a best-effort, per-process attempt limit. A 429 response supplies Retry-After in seconds. Clients must honour it; this limit is not a reserved quota or a service-level agreement. No removal of the current endpoints is scheduled.