Changelog
Make changes through the API
- Install & API
curl https://api.highseat.com/v1/sites/example.com/goals \ -H "Authorization: Bearer hs_live_…" \ -H "Idempotency-Key: 7f3c2a10-3f4e-4b7e-9d21-1c6a0e5b8f42" \ -H "Content-Type: application/json" \ -d '{"name":"Signup","type":"event","match":"signup"}'
The API used to read only. A write key can now make the changes an admin makes in the dashboard: create sites, change their settings, and manage goals, funnels, saved reports, chart notes and share links. It can also start a raw export.
Choose a key's access when you create it in Workspace settings, API keys. Every key made before writes existed stays a read key. Give a script a write key only when it changes something, and limit it to the sites it changes.
Send an Idempotency-Key header with a POST to make a retry safe. For 24 hours, a retry with the same key and the same body writes nothing and answers what the first call did.