# voicebin.ca

> An audio clip bin for uploading, sharing, and managing voice/audio files.
> Uploads receive stable view and direct download URLs, with owner controls for
> listing, metadata, deletion, and download limits. Audio is scan-gated before
> broad availability where required. Accounts, OAuth, and API keys are federated
> from pastebin.ca.

## How it works

- Upload an audio clip as raw bytes or multipart/form-data; metadata can include
  filename, title, and description.
- Public clips expose share/view and direct download URLs. Owners can list, inspect,
  and delete their clips, including scan state and download-limit metadata.
- Malware and abuse scanning can gate availability; clients should treat scan_state
  as authoritative for owner workflows.

## Developer docs

- [Developer guide](https://voicebin.ca/docs): REST API, MCP, OAuth, and discovery.
- [OpenAPI 3.1 spec](https://voicebin.ca/api/v1/openapi.json): the full REST contract.
- [MCP server](https://voicebin.ca/mcp): Model Context Protocol endpoint for AI agents.
- [Agent card](https://voicebin.ca/.well-known/agent.json): machine-readable capabilities.
- [MCP discovery](https://voicebin.ca/.well-known/oauth-protected-resource/mcp): protected-resource metadata.

## API summary

- POST https://voicebin.ca/api/v1/audio — upload an audio clip (scope voice:create). Raw body or multipart file; optional x-filename, x-title, x-description headers.
- GET https://voicebin.ca/api/v1/items/{id} — read audio metadata; owners see scan and limit fields (scope voice:read for owner API-key reads).
- GET https://voicebin.ca/api/v1/account/items — list your audio clips (scope voice:read); filters include q.
- DELETE https://voicebin.ca/api/v1/items/{id} — delete one of your audio clips (scope voice:delete).

## Authentication

- Account API keys are minted on https://pastebin.ca and audience-bound to https://voicebin.ca.
- Send them as: Authorization: Bearer pbca_live_…
- OAuth 2.1 + PKCE (with optional DPoP) is available for interactive MCP clients;
  pastebin.ca is the authorization server.

## Policy

- Uploaded audio may be scan-gated, blocked, removed, or rate limited for abuse.
- Owner-only fields expose scan state and download limits so clients can avoid
  assuming immediate public availability.
- Privacy: https://voicebin.ca/privacy
- Report abuse at https://voicebin.ca/abuse.
- The governing family policy lives at https://pastebin.ca/privacy, https://pastebin.ca/terms, and https://pastebin.ca/abuse.