Truto Environment Override Auditor
Mission
Decide whether an environment integration override is necessary, correct, too broad, stale, or causing an environment-specific bug.
Inputs
Use profile plus environment integration ID when available. Otherwise use integration slug/ID, account ID, customer symptom, or resource/method to resolve the environment integration.
Fetch
truto whoami -p "$PROFILE" -o json --no-color
truto integrations list --name "$INTEGRATION" -p "$PROFILE" -o json --no-color
truto environment-integrations list --integration-id "$INTEGRATION_ID" -p "$PROFILE" -o json --no-color
truto environment-integrations get "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color
truto environment-integrations show-override "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color
truto integrations get "$INTEGRATION_ID" -p "$PROFILE" -o json --no-color
For account-specific reports:
truto accounts get "$ACCOUNT_ID" -p "$PROFILE" -o json --no-color
truto capabilities "$ACCOUNT_ID" --target account -p "$PROFILE" -o json --no-color
truto logs --log-type unified_proxy_api --integrated-account-id "$ACCOUNT_ID" --start "$START" --end "$END" -p "$PROFILE" -o json --no-color
Review
is_enabledandshow_in_catalogmatch expected environment behavior.- Override only contains environment-specific deltas, not a stale copy of catalog config.
- Auth override preserves required format, header names, token URL, scopes, and secret references.
- Pagination override matches response examples and does not conflict with method-level pagination.
- Rate-limit override expressions match provider headers/bodies.
- Webhook override handles verification, signatures, event payload transform, and callback behavior.
- Base URL points to the intended sandbox/prod or regional host.
- Account tools/capabilities reflect the expected post-override behavior.
Safe Patch Pattern
Prefer deep-patch helpers over replacing the whole override:
truto environment-integrations override-auth "$ENV_INTEGRATION_ID" --stdin -p "$PROFILE" -o json --no-color
truto environment-integrations override-pagination "$ENV_INTEGRATION_ID" --stdin -p "$PROFILE" -o json --no-color
truto environment-integrations override-rate-limit "$ENV_INTEGRATION_ID" --stdin -p "$PROFILE" -o json --no-color
truto environment-integrations override-webhook "$ENV_INTEGRATION_ID" --stdin -p "$PROFILE" -o json --no-color
Use --clear only after confirming the specific override key is wrong and safe to remove.
Verify
truto environment-integrations show-override "$ENV_INTEGRATION_ID" -p "$PROFILE" -o json --no-color
truto capabilities "$ACCOUNT_ID" --target account -p "$PROFILE" -o json --no-color
truto proxy "$SAFE_RESOURCE" -m list -a "$ACCOUNT_ID" -p "$PROFILE" -o json --no-color -v
Output
Return base-vs-override differences, suspected bad key, exact patch body or clear command, verification command, and rollback note.