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

# Error Codes and Troubleshooting

> Documents API error codes and troubleshooting guide

Encountering errors while interacting with APIs is a common occurrence. Although the StackOne Unified API will try to remediate issues automatically, it is important to understand what each error code signifies.

This guide lists the error codes you may encounter while using the Documents API, the possible reasons behind these errors, and steps for resolution.

***

<Snippet file="errors/http-errors.mdx" />

***

## Provider Errors

When the underlying provider API returns an error, the StackOne Unified API includes any data returned by the provider in the `provider_errors` array:

```json theme={null}
{
  "statusCode": 404,
  "message": "Resource not found",
  "provider_errors": [
    {
      "status": 404,
      "url": "/api/v1/files/250",
      "raw": { "error": "File with id 250 does not exist" }
    }
  ]
}
```

<Tip>
  Always check the `provider_errors` array for additional context from the upstream provider. This can help diagnose issues specific to the connected system.
</Tip>

***

## Getting Help

For any unresolved issues or further assistance, contact our support team via your dedicated Slack channel or at [support@stackone.com](mailto:support@stackone.com).

<CardGroup cols={2}>
  <Card title="Status Page" icon="signal" href="https://status.stackone.com">
    Check system status and incidents
  </Card>

  <Card title="Request Tester" icon="flask" href="/documents/request-tester">
    Debug Documents requests directly in the dashboard
  </Card>

  <Card title="Request Logs" icon="scroll" href="/guides/request-logs">
    View detailed request history
  </Card>

  <Card title="Documents Integration Errors" icon="bug" href="/documents/integration-errors">
    Provider-specific Documents errors
  </Card>

  <Card title="AI Error Explainer" icon="robot" href="/guides/ai-features#error-explainer">
    Get AI-powered error resolution steps
  </Card>
</CardGroup>
