> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iCommerce Agent Sandbox Troubleshooting

> Common errors and fixes when running the agent in Sandbox.

# iCommerce Agent Sandbox Troubleshooting

Use this checklist when sandboxed agent runs fail or return unexpected results.

## Authentication Errors

* Confirm `ApiKey` is valid and not expired
* Verify the `Authorization` header format: `ApiKey YOUR_API_KEY`

## Missing CLI

* Ensure the sandbox image includes the `stateset` CLI
* Rebuild or update the runtime image if the CLI is missing

## Permission or Guardrail Failures

* Verify the command includes `--apply` for write actions
* Review guardrail policies for restricted operations

## Timeouts

* Increase `timeout_seconds` when creating the sandbox
* Reduce workflow size or split into smaller tasks

## Output/Logging Issues

* Stream command output to capture errors
* Store execution logs for auditability

## Related Documentation

* [Sandbox API Flow](/stateset-sandbox-api-flow)
* [iCommerce Agent Sandbox Runbook](/stateset-icommerce-agent-sandbox-runbook)