CodeCauseResolution
400 Bad Request- Missing required parameters
- Invalid step ID or instance ID
- Incorrect data format
- Authentication token issues - Attempting to complete already completed steps
- Validate all required fields are present
- Ensure IDs are current and valid
- Check data formatting matches API specifications
- Verify that authentication headers are properly formatted
- Query step status before attempting completion

401 Unauthorized

- Invalid or expired API token
- Token lacks necessary permissions
- Incorrect token format in headers

- Regenerate API tokens
- Verify token permissions match required operations
- Ensure proper header format. For example, for Next Matter it’s Authorization: Api-Key {key}

404 Not found

- Instance or step doesn’t exist
- Instance has been deleted
- Incorrect API endpoint URL

- Verify instance/step IDs before API calls
- Check if instance hasn’t been deleted
- Confirm API endpoint URLs match documentation

429 Too many requests

- Exceeded rate limits

- Distribute requests over time (fewer than 3000 requests per hour)
- Ehen this error shows when instances are created, implement delays between instance creation calls. The system has a rate limit of around 100 instances per batch
- Retry the request after 1 minute or, if still fails, 5 minutes

500 Internal server error

- Server-side issues
- Timeouts on complex operations

- Check system status page and report to support
- Retry the request after 1 minute or, if still fails, 5 minutes

504 Gateway timeout

- May happen when filtering large datasets

We have a 60-second timeout limit on all API endpoints.
- Use date range filters to limit data scope
- Retry the request after 1 minute or, if still fails, 5 minutes