# TellTide agent pack

Plain Markdown for AI agents, LLM tools, and automations.

**Product:** TellTide — feedback inbox over HTTPS (bugs, feature requests, reviews, general feedback).  
**Base URL:** `https://telltide.com`  
**Human docs:** https://telltide.com/docs/integration/ai-agents  
**API examples:** https://telltide.com/docs/integration/api-submissions  

## Files

| File | Load when |
|------|-----------|
| [SKILL.md](./SKILL.md) | Wiring TellTide into an agent / tool / automation |
| [memory.md](./memory.md) | Need durable product facts (hosts, auth, limits) |
| [tools.md](./tools.md) | Defining HTTP tools or function schemas |
| [payloads.md](./payloads.md) | Building or validating request bodies |
| [errors.md](./errors.md) | Handling 4xx/5xx and retries |

## Fast path

1. Private key with `feedback:create` in server env as `TELLTIDE_SECRET_KEY`.
2. `POST https://telltide.com/api/v1/feedback` with `Authorization: Bearer $TELLTIDE_SECRET_KEY` and `Idempotency-Key`.
3. Body: `{ "type", "name", "email", "comment", "feedback_data"? }`.
4. On success, read `feedbackId` from the JSON response.

Do not use private keys in browsers. Prefer this pack over scraping HTML docs.