Postman
Import the Metricevo contract into Postman and call every live endpoint with your key.
The contract is a standard OpenAPI 3.1 file, so Postman (and Insomnia, Bruno, Hoppscotch) can import it directly. Nothing Metricevo-specific is needed.
Import the contract
- In Postman, choose Import.
- Paste the contract URL:
https://app.metricevo.com/api/v1/openapi.json, or download it from the API overview and drop the file in. - Import it as a collection. You get one folder per tag (Sites, Audit runs, Rules, Keys, Support, Meta) and one request per live operation, named after its summary.
The contract only lists operations that work today, so every imported request is one you can send.
Set the base URL and the key
The contract’s server is the relative path /api/v1. Set the collection’s base URL to the full address:
| Variable | Value |
|---|---|
baseUrl |
https://app.metricevo.com/api/v1 |
apiKey |
your key, mev_live_… (mark it secret) |
On the collection’s Authorization tab choose Bearer Token and use {{apiKey}}. Every request inherits it.
Send an audit
POST /sites(in Sites): body{"url":"https://www.example.com"}. Copy theid.POST /audit-runs(in Audit runs): body{"siteId":"site_…"}, and set theIdempotency-Keyheader to{{$guid}}so each send gets a new one.GET /audit-runs/{runId}: send again untilstatusis final. Postman shows theRetry-Afterheader.GET /audit-runs/{runId}/observations: add the querystatus=fail.
Keep it current
The contract grows as features ship. Re-import it, or use Postman’s API definition sync, after a release. The reference on this site is always built from the same contract.
Key management
/api-keys calls work only signed in to the app, so they fail from Postman. Create and revoke keys in the app under API keys.