rest api
paid build your voice users call hold your voice rest endpoints for analyze, profiles, usage, and rewrite. most users only need cli or mcp.
quick answer
server-side integrations only — bearer auth from dashboard → api tab.
use this for
- server-side integrations and ci
- batch jobs that cannot use mcp
- automations that need http, not a local agent
steps
- create an api key in dashboard → api (build your voice plan).
- use copy with prompt to hand setup to an ai agent.
- verify: curl -s -H "Authorization: Bearer KEY" https://holdyourvoice.com/v1/profiles
- pass profile_id into analyze/rewrite payloads.
- monitor usage on dashboard → usage.
details to know
- core endpoints: GET /v1/profiles, GET /v1/usage, POST /v1/analyze, POST /v1/rewrite.
- rest api complements cli/mcp — not required for normal writing work.
- rate limits apply per key (build your voice: 10 req/min).
- find your voice uses mcp, not rest api, unless grandfathered with existing keys.
limits and edge cases
- never expose bearer keys in client-side browser js.
- rotate keys after teammate offboarding.
ready to try it on your own drafts?get started for $1 →