Errors and retry behavior

Status	Meaning	Integrator action
400	Invalid path parameter or request body	Correct the request; do not blindly retry.
401	Missing, malformed, revoked, or unknown key	Check secret deployment or rotate the key.
404	Survey, scoring run, deletion, or organization context is not available to the key	Check identifiers and organization ownership.
429	Per-key rate limit exceeded	Wait for Retry-After, then retry with jitter.
500	Ramon could not complete the operation	Retry only a bounded number of times and surface the failure.

Retry rules

• Survey provisioning is safe to repeat for the same LimeSurvey instance and external survey; it reuses the existing Ramon survey.
• A duplicate scoring request while a run is active returns the active run.
• A completed deletion request returns the existing completed deletion record.
• Polling is not a tight loop: use a bounded interval and stop at a terminal completed or failed status.

For participant-facing pages, collector failure is fail-open: the survey should continue normally while your operations tooling records the issue.