Factories
infrastructure_timeout
The task was forcibly terminated because it remained active past the maximum allowed runtime. Retry the task or contact support if it persists.
Walk me through resolving this issue: https://docs.warp.dev/factories/api-and-sdk/troubleshooting/errors/infrastructure-timeout/
The infrastructure_timeout error occurs when a cloud agent task runs past the platform’s maximum allowed runtime and is forcibly terminated.
Details
Section titled “Details”- HTTP Status:
500 Internal Server Error - Retryable: No
- Task State: ERROR
When does this occur?
Section titled “When does this occur?”This error is returned when:
- The task runs longer than the platform’s maximum allowed runtime and is terminated by the periodic stale-task cleanup job
- The agent process never reports a terminal status within that window (for example, the process is hung or stuck on a long-running command)
- A networking or infrastructure issue causes the task to stall silently without reporting completion
Example response
Section titled “Example response”{ "type": "/factories/api-and-sdk/troubleshooting/errors/infrastructure-timeout/", "title": "The task exceeded the maximum allowed runtime and was terminated.", "status": 500, "instance": "/api/v1/agent/tasks", "error": "The task exceeded the maximum allowed runtime and was terminated.", "retryable": false, "trace_id": "abc123..."}How to resolve
Section titled “How to resolve”- Retry the task. If it consistently times out, break the work into smaller, shorter-running subtasks or reduce the scope of the prompt.
- Review the environment configuration for setup commands or MCP servers that block on user input, long downloads, or unresponsive network calls.
- Contact Warp support and include the
trace_idfrom the error response if the issue persists.
Related
Section titled “Related”- Cloud agents overview — How cloud agent tasks work
- internal_error — Other platform-level errors
- Cloud Agents FAQs — Common questions about cloud agents