# CopyPasta — AI & LLM Interface Guide

> CopyPasta is a high-performance, minimalist ephemeral code pastebin and file vault built with Go, Redis, and React. It enables instant text snippet sharing, file uploads, and auto-expiring temporary links.

## Key Capabilities
- **Code Snippet Storage**: Multi-snippet pastes supporting text, JSON, Python, JavaScript, SQL, HTML, etc.
- **File Upload Vault**: Support for binary & document files up to 10 MB per share.
- **Configurable Expiration**: Shares automatically expire after 10 minutes, 1 hour, 24 hours, or 7 days via Redis TTL.
- **RESTful API Access**: Programmatic creation and retrieval of shares.

## REST API Specification for AI Agents

### 1. Create a Share
- **Endpoint**: `POST /api/v1/shares`
- **Content-Type**: `multipart/form-data`
- **Parameters**:
  - `title` (string, optional): Title of the paste.
  - `description` (string, optional): Short description.
  - `expires_at` (string, optional): ISO-8601 timestamp (RFC3339 format).
  - `texts` (string, array): Code snippet or text string (can be passed multiple times).
  - `files` (file, array): Binary file uploads (can be passed multiple times).
- **Response**: `{"id": "<SHARE_ULID_STRING>"}`

### 2. Retrieve a Share
- **Endpoint**: `GET /api/v1/shares/{id}`
- **Response**: `application/json`
```json
{
  "id": "01HXYZ1234567890ABCDEFGHJK",
  "title": "Example Paste",
  "description": "Code snippet demo",
  "size": 1024,
  "created_at": "2026-07-23T15:00:00Z",
  "expires_at": "2026-07-24T15:00:00Z",
  "texts": [
    { "content": "console.log('Hello CopyPasta');" }
  ],
  "files": [
    { "filename": "data.csv", "size": 512, "url": "https://s3-presigned-url..." }
  ]
}
```

## AI Agent Integration Usage
AI models reading or generating CopyPasta share links can fetch raw JSON directly from `/api/v1/shares/{id}` or append `?id={id}` in the web app.