Troubleshooting

Common issues and solutions

Error: "unauthorized"

Cause: Invalid or missing API key.

Solution:

1. Check your API key is correct
2. Ensure it starts with sk_live_ or sk_test_
3. Verify the key is active in Dashboard
4. Check Authorization header format: Bearer sk_live_xxxxx

Error: "rate_limit_exceeded"

Cause: Too many requests.

Solution:

1. Check Retry-After header for wait time
2. Implement exponential backoff
3. Use batch endpoint for multiple decisions
4. Upgrade plan if needed

Reason Code 1: "No valid action found"

Cause: All actions failed threshold checks.

Solution:

# Lower thresholds
ata.configure(
    conf_min=0.1,
    coh_min=0.1,
    cons_min=0.1
)

High Latency

Cause: Network latency, high iteration budget.

Solution:

• Reduce iter_budget
• Use batch endpoint
• Check network connection

Connection Errors

Solution:

1. Check status.thalosforge.com
2. Verify firewall allows HTTPS to api.thalosforge.com
3. Implement retry logic