# Tests & Troubleshooting {% hint style="info" %} _{Most “mystery” failures are typos, wrong environment, or expired tokens. Boring fixes beat heroic narratives.} {% endhint %} ***

_{This page means}

This page is	This page is not
_{A calm playbook for operators}	_{A root cause analysis for every possible vendor outage}
_{Save, Test, Clear semantics}	_{A promise that every integration will self heal}

_{What Test does?}

_{Test asks the outside world a small question your deployment defines.}
_{Pass means the handshake succeeded for that moment. It is not a lifetime warranty.}

_{What Remove does?}

_{Remove deletes the stored value from ARIA for that integration. It does not delete the key at Stripe, GitHub, or any other vendor. If a secret leaked, rotate at the vendor, then Remove and Save it.}

_{Common failure modes}

Symptom	Likely cause	First move
_{Test fails right after paste}	_{Trailing space or wrong clipboard chunk}	_{Paste into a scratch buffer, trim, Save again}
_{Test fails only in prod}	_{Wrong environment key or IP allow list}	_{Compare labels, ask platform owner}
_{Intermittent failures}	_{Rate limits or flaky vendor region}	_{Slow down, retry with backoff, check vendor status}
_{“Configured” but flows empty}	_{Downstream feature gate or missing companion key}	_{Read the integration page for that flow’s full chain}

_{Never pass API keys into chats or share them}

{% stepper %} {% step %} _{**Change one variable at a time**} _{Key, scope, or routing. Never all three in one save.} {% endstep %} {% step %} _{**Copy errors verbatim into your ticket**} _{If you escalate. Paraphrase is how truth dies.} {% endstep %} {% step %} _{**Rotate on suspicion, not on shame**} _{Security is a habit, not a mood.} {% endstep %} {% endstepper %} ***

_{Ask a question}

_{If Test failed during a live demo, what is the single sentence you would say out loud while you fix it?}
_{Rehearse that sentence once. Calm beats clever.}

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.ariaagi.com/settings-and-integrations/tests-and-troubleshooting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.