API discovery

Artos public discovery endpoints

This page documents the machine-readable endpoints Artos publishes for agent and API discovery. Browsers get HTML by default, while agents can request markdown by sendingAccept: text/markdownto HTML pages.

Published endpoints

Path	Format	Purpose
/.well-known/api-catalog	application/linkset+json	Machine-readable API catalog for public Artos discovery endpoints.
/api/openapi.json	application/openapi+json	Minimal OpenAPI document for public discovery, skills, and health routes.
/health	application/json	Simple health status with timestamp and deployed app version.
/.well-known/agent-skills/index.json	application/json	Published Artos skills index with integrity digests for each SKILL.md file.

Homepage discovery headers

Link: </.well-known/api-catalog>; rel="api-catalog"; type="application/linkset+json"
Link: </api/openapi.json>; rel="service-desc"; type="application/openapi+json"
Link: </docs/api>; rel="service-doc"; type="text/html"

Notes

These endpoints describe the public discovery surface that exists today. They do not publish placeholder OAuth, MCP, or commerce metadata.

For machine clients, the API catalog is the best entry point. For humans, this documentation page is the easiest place to start.