Skip to main content
POST
/
readiness
/
compliance
/
refresh
Re-run the storefront compliance check
curl --request POST \
  --url https://api.interchange.io/api/v2/storefront/readiness/compliance/refresh \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agentId": "<string>"
}
'
import requests

url = "https://api.interchange.io/api/v2/storefront/readiness/compliance/refresh"

payload = { "agentId": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({agentId: '<string>'})
};

fetch('https://api.interchange.io/api/v2/storefront/readiness/compliance/refresh', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "category": "<string>",
  "isBlocker": true,
  "method": "<string>",
  "details": "<string>",
  "actionLabel": "<string>",
  "compliance": [
    {
      "agentId": "<string>",
      "agentUrl": "<string>",
      "passed": true,
      "tracks": [
        {
          "track": "<string>",
          "label": "<string>",
          "durationMs": 123,
          "failureReason": "<string>"
        }
      ],
      "summary": "<string>",
      "observations": [
        {
          "category": "<string>",
          "message": "<string>"
        }
      ],
      "durationMs": 123,
      "error": "<string>"
    }
  ]
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}
{
  "data": null,
  "error": {
    "code": "<string>",
    "message": "<string>",
    "field": "<string>",
    "details": {}
  }
}

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Request body for re-running the storefront compliance check.

agentId
string

Scope the live re-run to a single agent. When omitted, every testable agent on this storefront is re-checked.

Minimum string length: 1

Response

object | null

Re-run the storefront compliance check

Individual readiness check result

id
string
required
name
string
required
description
string
required
category
string
required
status
enum<string>
required

Status of a readiness check. optional is reserved for checks that are explicitly skipped (e.g. billing in non-production environments) — they are not required before the storefront can start transacting.

Available options:
complete,
partial,
missing,
optional
isBlocker
boolean
required
method
string
details
string
action
enum<string>

Where this step resolves. Absent → the widget falls back to its own routing for the check id.

Available options:
inline_currency,
policy,
open,
chat,
recheck
actionLabel
string

Outcome-named action label for this step (e.g. "Connect ad server", "Set currency") — names the task, not the tool. Absent → the widget derives a label from the check name.

compliance
object[]

Per-agent compliance results (present on agent_connectivity checks)