API › Issues

Recheck an issue

Runs the same check at the same place on your live site, right after your deploy. For a repository, Rustine starts a new analysis of the default branch (pending, with its scan_id).

POSThttps://api.rustine.io/v1/issues/{issue_id}/recheck

OAuth permission: scans:run · an API key has them all

Open in Claude Open in ChatGPT

Free, up to 60 rechecks per project and per day. Deploy (or push) the fix first: Rustine looks at what is live.

Path parameters

issue_idstringrequired
Issue id.

Headers

Idempotency-Keystringoptional
A unique key (1 to 255 printable characters, a UUID is fine) to retry this request safely: the first response is replayed for 24 hours; the same key with another request answers 409 idempotency_conflict.

Response

objectstring
issue_idstring
The issue.
statusstring
fixed (closed), still_open, or pending for a repository issue: a new analysis of the default branch was started (scan_id); poll it, then read the issue.
fixedstill_openpending
checked_atstring
When the check ran.
evidencestring
What the check saw this time.
scan_idstring | null
Repository issue: the analysis that settles it.

Errors

Status	error.code	What happens
400	idempotency_key_invalid	The `Idempotency-Key` header must be 1 to 255 printable characters.
401	authentication_required	No key in the request. Pass it in the `Authorization: Bearer rst_…` header, never in the address.
401	invalid_api_key	The key or OAuth token is wrong, revoked or expired. Check it is copied in full, or create a new key.
402	api_plan_required	The workspace is on the Free plan. The API comes with Pro, or on a 14-day trial with Solo.
402	api_trial_ended	Solo's 14-day trial is over. Move to Pro: your keys work again at once.
402	project_paused	The project is paused: your plan covers fewer projects than your workspace has. Its issues stay readable, but nothing new runs.
403	scope_missing	The OAuth token lacks the permission this route needs (shown on its page). Reconnect the agent to grant it. An API key has every permission.
404	resource_not_found	Nothing with this id in the key's workspace. An object of another workspace answers the same: its existence is never revealed.
409	proof_required	The site must first be proved yours (full audit, fix, marking). Prove it in the app: DNS, file or meta tag.
409	idempotency_conflict	This `Idempotency-Key` was already used for another request (method, path or body). A new action takes a new key.
409	idempotency_in_progress	A request with this `Idempotency-Key` is still running. Retry in a moment.
429	rate_limited	Too many requests for this key (120 per minute). Wait `Retry-After` seconds.
429	recheck_limit_reached	Too many rechecks on this project today (60 per day). Try again tomorrow.
429	repository_analyses_limit_reached	The workspace started many repository analyses in the last 24 hours. Try again later.
500	internal_error	An error on our side, reported automatically. Retry later; give the `Request-Id` to support if it comes back.
502	recheck_failed	The recheck could not complete (site unreachable?). Check the site answers, then retry.
503	service_unavailable	Rustine is unavailable for a moment. Retry with the same `Idempotency-Key`.