api authentication
send Authorization: Bearer <key> on rest requests. keys are created in dashboard → api tab.
quick answer
the exact header format for scripts and server jobs.
use this for
- writing curl examples
- debugging 401 responses
- onboarding an engineer to the api
steps
- create a key in dashboard → api.
- add Authorization: Bearer YOUR_API_KEY to each request.
- base url: https://holdyourvoice.com
- use copy with prompt on the api tab to hand setup to an ai agent.
- handle 401 by rotating or reissuing keys.
details to know
- keys do not replace hyv login for cli — cli uses device pairing.
- core endpoints: GET /v1/profiles, GET /v1/usage, POST /v1/analyze, POST /v1/rewrite.
- build your voice plan required unless grandfathered.
limits and edge cases
- revoke compromised keys immediately.
ready to try it on your own drafts?get started for $1 →