Factories
internal_error
An unexpected server-side error occurred. The platform will automatically retry. Contact support if the issue persists.
Walk me through resolving this issue: https://docs.warp.dev/factories/api-and-sdk/troubleshooting/errors/internal-error/
The internal_error is a catch-all for unexpected server-side errors. The platform automatically retries these errors before marking the task as failed.
Details
Section titled “Details”- HTTP Status:
500 Internal Server Error - Retryable: Yes (automatic)
- Task State: ERROR
When does this occur?
Section titled “When does this occur?”This error is returned when:
- An unexpected condition occurred on the server that does not match any specific error category
- An internal service dependency failed or timed out
- An unclassified error occurred during task processing
Example response
Section titled “Example response”{ "type": "/factories/api-and-sdk/troubleshooting/errors/internal-error/", "title": "An unexpected error occurred. Please try again later. If the issue persists, contact support.", "status": 500, "instance": "/api/v1/agent/tasks", "error": "An unexpected error occurred. Please try again later. If the issue persists, contact support.", "retryable": true, "trace_id": "abc123..."}How to resolve
Section titled “How to resolve”No action is typically needed — the platform will automatically retry the task.
If the error persists:
- Wait a few minutes and try again.
- Contact Warp support and include the
trace_idfrom the error response.
Related
Section titled “Related”- Cloud agents overview — How cloud agent tasks work
- Cloud Agents FAQs — Common questions about cloud agents