APS Error Codes Reference
Complete guide to APS error codes with causes, solutions, and RAPS commands to prevent or resolve issues.
Translation Errors
TranslationWorker-InternalFailure
The most common translation error, often caused by file corruption, unsupported features, or resource limits.
Common Causes:
- File contains proprietary or licensed content
- File is corrupted or incomplete
- Unsupported CAD version or features
- File exceeds size limits (500MB)
RAPS Solution:
raps translate --validate-first <file>
raps translate --force-version 2023 <file>REVIT_FILE_TRANSLATION_ERROR
Revit-specific translation failures, often related to missing families or corrupt project files.
Solutions:
- Ensure all linked files and families are embedded
- Use Revit's "Purge Unused" before uploading
- Check for corrupt elements using Revit's repair tools
RAPS Solution:
raps translate --revit-options="embed-links,purge-unused" <file>Authentication Errors
401 Unauthorized
Invalid or expired access token. Most commonly occurs with 3-legged OAuth tokens that expire after 1 hour.
RAPS Solution:
raps auth refresh
raps auth test403 Forbidden
Insufficient scopes or permissions. Check your app's OAuth scopes against the required permissions.
RAPS Solution:
raps auth scopes list
raps auth login --scopes="data:read data:write"Rate Limit Errors
429 Too Many Requests
Rate limit exceeded. APS has different limits per endpoint: 100/min for most APIs, 10/min for translation.
Rate Limits:
- Model Derivative: 10 requests/minute
- Data Management: 100 requests/minute
- Viewer: 1000 requests/minute
RAPS Solution (Built-in retry):
raps translate --retry-on-rate-limit <file>
raps batch --max-concurrent=5 <files>Region & Data Center Errors
REGION_MISMATCH
Bucket or object is in a different region than expected. Ensure consistent region usage.
RAPS Solution:
raps config set region US
raps bucket create --region=US my-bucketQuick Reference
| Error Code | Meaning | Quick Fix |
|---|---|---|
| 401 | Invalid/expired token | raps auth refresh |
| 403 | Insufficient permissions | raps auth scopes list |
| 429 | Rate limit exceeded | raps --retry-on-rate-limit |
| 500 | Translation failure | raps translate --validate-first |