Type at least two letters.

    ↑ ↓ to moveEnter to open

    Postman

    Import the Metricevo contract into Postman and call every live endpoint with your key.

    Updated

    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

    1. In Postman, choose Import.
    2. Paste the contract URL: https://app.metricevo.com/api/v1/openapi.json, or download it from the API overview and drop the file in.
    3. 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

    1. POST /sites (in Sites): body {"url":"https://www.example.com"}. Copy the id.
    2. POST /audit-runs (in Audit runs): body {"siteId":"site_…"}, and set the Idempotency-Key header to {{$guid}} so each send gets a new one.
    3. GET /audit-runs/{runId}: send again until status is final. Postman shows the Retry-After header.
    4. GET /audit-runs/{runId}/observations: add the query status=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.