Developer docs

Recheck an issue

POST/sites/{siteId}/issues/{issueId}/recheck

Scope: issues:recheck
MCP tool: recheck

Queue a recheck of an issue Reads every page the issue lists again, fresh (past page caches and CDNs); the issue is resolved only when the recheck no longer finds it. It also checks again the written changes of the issue's latest batch, so a not_live change that has appeared becomes applied.

Parameters

Name	In	Details
`siteId`Required	path	stringWebsite id, from GET /sites.
`issueId`Required	path	stringIssue id, from GET /sites/{siteId}/issues or /actions.

Response

200 · application/json

Field	Details
`queued`	true or false · required; Always true
`crawlId`	string or null · required; Id of the recheck crawl
`note`	string · required; What happens next
`link`	string · required; The issue in the app

Errors

Status	Meaning
`401`	Missing, unknown or revoked key. Codes: `missing_key`, `invalid_key`.
`403`	The key lacks the scope, covers another website, or its owner lost access. Codes: `missing_scope`, `other_site`, `owner_left`, `no_owner`, forbidden.
`404`	Not found. Codes: `not_found`.
`409`	Conflict with the current state. Codes: `already_queued`.
`422`	The request cannot be carried out. Codes: `cannot_recheck`.
`429`	Too many requests this hour for this key. Codes: `rate_limited`.

Example request

curl -X POST \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites/SITE_ID/issues/ISSUE_ID/recheck"

const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/issues/ISSUE_ID/recheck", {
  method: "POST",
  headers: { Authorization: "Bearer mr_ws_…" },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();

import requests

res = requests.post(
    "https://app.monoranks.com/api/v1/sites/SITE_ID/issues/ISSUE_ID/recheck",
    headers={"Authorization": "Bearer mr_ws_…"},
)
res.raise_for_status()
data = res.json()

<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/issues/ISSUE_ID/recheck");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…"],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

import axios from "axios";

const { data } = await axios.post("https://app.monoranks.com/api/v1/sites/SITE_ID/issues/ISSUE_ID/recheck", { headers: { Authorization: "Bearer mr_ws_…" } });

Example response

{
  "queued": true,
  "crawlId": "e5a7c9e1-3f5b-4d7f-9b1d-5f7b9d1f3b5c",
  "note": "The issue is verified resolved only when this recheck no longer finds it.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/issues/b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d"
}

{
  "error": {
    "code": "missing_key",
    "message": "Send the key as Authorization: Bearer mr_site_…"
  }
}

{
  "error": {
    "code": "missing_scope",
    "message": "This key does not have the scope this call needs."
  }
}

{
  "error": {
    "code": "not_found",
    "message": "Issue not found."
  }
}

{
  "error": {
    "code": "already_queued",
    "message": "A recheck is already queued for this issue."
  }
}

{
  "error": {
    "code": "cannot_recheck",
    "message": "This issue lists no pages, so a recheck has nothing to read. Run a full audit to check it again."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "More than 1200 requests this hour for this key."
  }
}

The MCP server does the same with the tool recheck.