PUT /v1/reverification

Family: Verification and finder · Operation ID: v1_update_reverification

Access

Workspace API key: Authorization: Bearer <key>. The key is scoped to its workspace; the backend checks operation permissions and quota.

Open re-check settings

Required scope: settings

Create a key in Developer settings. Set API_BASE_URL to the current app origin.

Request example

curl --fail-with-body -X PUT "$API_BASE_URL/v1/reverification" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

Request body · application/json

{
  "$ref": "#/components/schemas/UpdateReverificationRequest",
  "definition": {
    "description": "Turns scheduled re-checks on or off for the workspace and sets how old a\nresult may get before it is checked again.",
    "properties": {
      "batch_size": {
        "description": "Addresses re-checked in each run (1 to 1,000).",
        "format": "int32",
        "type": "integer"
      },
      "enabled": {
        "type": "boolean"
      },
      "staleness_days": {
        "description": "Re-check results older than this many days (1 to 365).",
        "format": "int32",
        "type": "integer"
      }
    },
    "required": [
      "enabled",
      "staleness_days"
    ],
    "type": "object"
  }
}

Responses

200

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ReverificationStatusResponse"
      }
    }
  },
  "description": "Reverification schedule status"
}

400

{
  "description": "Invalid schedule"
}

default

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract