> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sundaypyjamas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Artifacts API

> Generate structured, LLM-authored reports from your own aggregated data

## Overview

The Artifacts API turns data you already have — aggregates, metrics, sample records — into a structured, narrative report: an executive summary, categorized insights, and follow-up considerations, generated by an LLM against a fixed output schema so it's safe to render directly in your product.

<Info>
  Unlike the Chat API, you don't send free-form prompts here. You send **data** (aggregates + samples) and a **template**, and the model returns a validated JSON report shaped to that template.
</Info>

## Base URL

```
https://suite.sundaypyjamas.com/api/v1/artifacts
```

## Authentication

```http theme={null}
Authorization: Bearer spj_ai_your_api_key_here
```

## Resources

<Card title="Generate Artifact" icon="file-lines" href="/api-reference/artifacts/generate">
  POST aggregated data and get back a structured insight report.
</Card>
