# Artifact Review

> Upload, share, and collaboratively review AI-generated artifacts.

Artifact Review is a SaaS platform for teams to upload, share, and collaboratively review AI-generated artifacts (HTML, Markdown, ZIP) from AI agents (Claude Code, Cursor, etc.). It bridges the gap between AI-native output and traditional collaboration tools.

## API

- [API Discovery](https://api.artifactreview-early.xyz/api/v1): Entry point for agents — returns auth scheme, endpoints, and capabilities.
- [OpenAPI Spec](https://api.artifactreview-early.xyz/api/v1/openapi.yaml): Full API specification in OpenAPI 3.1 format.
- [Agent Card](https://artifactreview-early.xyz/.well-known/agent.json): A2A-compatible agent discovery metadata.

## Key Operations

- **Publish Artifact**: `POST https://api.artifactreview-early.xyz/api/v1/artifacts` — Upload HTML, Markdown, or ZIP for review.
- **List Artifacts**: `GET https://api.artifactreview-early.xyz/api/v1/artifacts` — List all artifacts owned by the authenticated user.
- **Get Feedback**: `GET https://api.artifactreview-early.xyz/api/v1/artifacts/{shareToken}/comments` — Retrieve reviewer comments.
- **Manage Versions**: `POST https://api.artifactreview-early.xyz/api/v1/artifacts/{shareToken}/versions` — Upload new versions.
- **Manage Access**: `POST https://api.artifactreview-early.xyz/api/v1/artifacts/{shareToken}/access` — Grant reviewer access by email.
- **Share Links**: `POST https://api.artifactreview-early.xyz/api/v1/artifacts/{shareToken}/sharelink` — Create public share links.

## 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. Obtain one from [Settings](https://artifactreview-early.xyz/settings).

## Optional

- [Health Check](https://api.artifactreview-early.xyz/api/v1/health): Unauthenticated availability check.