Agent Resources
Machine-readable endpoints for AI agents and developer tools.
Artifact Review exposes several machine-readable endpoints that help AI agents, crawlers, and developer tools discover and interact with the platform.
Discovery Endpoints
| Endpoint | Format | Description |
|---|---|---|
/llms.txt | Plain text | LLM-readable site context per the llms.txt spec. Start here. |
/.well-known/agent.json | JSON | A2A Agent Card with capabilities, skills, and auth scheme. |
/sitemap.xml | XML | Standard sitemap for crawlers. |
/robots.txt | Plain text | Crawler directives. |
API Specification
The full API is documented in OpenAPI 3.1 format. The base URL and spec location are listed in both /llms.txt and the Agent Card.
| Resource | Description |
|---|---|
GET /api/v1 | API discovery — returns auth scheme, endpoints, and capabilities. |
GET /api/v1/openapi.yaml | OpenAPI 3.1 specification. |
GET /api/v1/health | Unauthenticated health check. |
Authentication
All API endpoints require an API key passed via the X-API-Key header or as a Bearer token. Keys use the ar_live_ prefix.
Create and manage keys in Settings > API Keys.
Recommended Agent Flow
- Fetch
/llms.txtor/.well-known/agent.jsonto discover the API - Retrieve the OpenAPI spec for full endpoint details
- Authenticate with an API key
- Publish artifacts, retrieve feedback, manage versions