Skip to main content
POST
Resolve Comment
Use this API to resolve one comment of a check, for a person (by: "user") or an MCP client (by: "mcp"). The comment becomes Resolved and waits for the scan that verifies it (pendingVerify: true). Only a scan verifies: see Statuses. The resolve starts a verify rescan, which uses AI credits at the flat rescan rate. Resolves on one project within 15 seconds share one rescan per agent, so a fresh resolve answers queued: true with no run id yet. Resolve is idempotent. Resolving a comment that already waits for its rescan answers alreadyPending: true, starts nothing and charges nothing. A comment a scan already verified is refused: reopen it first. A rejected comment takes the Resolved status and nothing else: no verify rescan, no charge, no pendingVerify. It answers { rescanExecutionId: null, queued: false, alreadyPending: false } and stays rejected (statusKind: "rejected"), so it still counts nowhere. The comment can be an agent comment, or a person’s comment attached to a check. An agent comment written before the checks engine, with no check, is Resolved and its agent scans its page once, charged like any one-page scan. A person’s comment that is not attached to a check is refused.

Endpoint

POST https://api.velt.dev/v2/agents/checks/comments/resolve

Headers

string
required
Your API key.
string
required

Body

Params

object
required
The schema uses .strict(): unknown fields are rejected.

Example Requests

Response

Success Response (fresh resolve)

Success Response (already waiting)

All three are false / null when no verify rescan is involved: the workspace has no store database, the comment has no check, or the rescan could not be queued (the next scan of the comment’s pages then verifies or reopens it).

Failure Response

Errors:
  • INVALID_ARGUMENT for a body outside the schema: a missing annotationId, by or userId, a by other than "user" or "mcp", or an unknown field;
  • NOT_FOUND with CHECKS_COMMENT_NOT_FOUND (no such comment in the project);
  • FAILED_PRECONDITION with CHECKS_ALREADY_VERIFIED (a scan already verified the comment: reopen it first) or CHECKS_NOT_AGENT_COMMENT (a person’s comment not attached to a check).