Skip to main content

​
Quick Diagnostic

Not sure where to start? Answer these questions to find the right solution:

Can't create a session?

Check API key, rate limits, or agent name

Session not found?

Session may be deleted, expired, or ID is incorrect

Agent stuck or not responding?

Agent may need input, task too complex, or website issues

Getting timeout errors?

Connection timeouts or rate limiting issues

Authentication failing?

API key issues or snapshot problems

Webhooks not working?

Webhook delivery or duplicate events

​
Common Issues

​
Session Issues

Session Creation Fails

Unable to create a new session

Session Not Found (404)

Get 404 error when accessing a session

Session Stuck Initializing

Session status remains “initializing” too long

​
Agent Behavior

Agent Not Completing Tasks

Agent status stuck at “running” indefinitely

Incomplete Results

Agent finishes but doesn’t provide all data

Agent Makes Errors

Agent provides incorrect information

​
API & Network

Connection Timeouts

Requests timeout before completing

Rate Limiting (429)

Too many requests causing rate limit errors

Messages Not Appearing

Sent messages but not receiving responses

SSE Parsing Issues

Difficulty parsing Server-Sent Events

​
Authentication

401 Unauthorized

Authentication failing

Auth Not Preserved

Authentication state lost when restoring from snapshot

Snapshot Restoration Fails

Unable to restore from snapshot

​
Webhooks

Webhooks Not Received

Webhook events are not being delivered

Duplicate Events

Receiving duplicate webhook events

​
Data & Formatting

JSON Parsing Errors

Unable to parse agent responses as JSON

​
Debug Checklist

Before contacting support, verify these common issues:
1

1. Verify Authentication

http GET https://api.agi.tech/v1/models \
  Authorization:"Bearer $AGI_API_KEY"
✓ API key is correct and active
✓ Bearer token format is used (Bearer {key})
2

2. Check Session State

http GET https://api.agi.tech/v1/sessions/$SESSION_ID/status \
  Authorization:"Bearer $AGI_API_KEY"
✓ Session was created successfully
✓ Session still exists (not deleted)
✓ Session status is “ready” or “running”
3

3. Test Basic Message Flow

http POST https://api.agi.tech/v1/sessions/$SESSION_ID/message \
  Authorization:"Bearer $AGI_API_KEY" \
  message="Reply with 'OK'"
✓ Try a simple “Hello” or “OK” message
✓ Verify basic message flow works
✓ Isolate the problem
4

4. Review Task Instructions

✓ Instructions are clear and specific
✓ Output format is specified
✓ Edge cases are handled

​
Still Need Help?

Check API Status

See if there are any ongoing incidents

Contact Support

Get help from our team

View Examples

See working implementation examples
When contacting support, please include:
  • Session ID (if applicable)
  • Error messages
  • Request/response examples
  • Steps to reproduce