# Upstate Recycling Technologies

Public developer documentation for systems that integrate with Upstate Recycling Technologies.

## Docs

- [Bottle counter integration](/docs/bottle-counter-integration): Human-readable public guide for physical bottle counter devices.
- [Bottle counter integration Markdown](/docs/bottle-counter-integration.md): AI-readable source for count-entry creation, recording upload, expired upload URL regeneration, failed upload cleanup, ZIP archive upload, and management review behavior.

## Integration Surface

- Primary machine endpoint: `POST /api/counters/entries`
- Recording upload lifecycle endpoint: `POST`, `PATCH`, or `DELETE /api/counters/entries/[counterEntryId]/video-upload`
- Authentication: `Authorization: Bearer <counterApiKey>` or `x-counter-api-key: <counterApiKey>`
- Public docs do not include or expose counter API keys. A master admin provisions and rotates keys in system management.
- Prefer the Markdown document over scraping HTML when building automated agents.