# Troubleshooting

Find the cause of common problems before repeating a task or changing configuration.

Source: https://docs.opser.com/help/troubleshooting/

## An app or setting is missing
Check that you are in the correct workspace and signed in as the intended user. Ask an administrator to verify the app is installed and inspect your effective permissions, including access groups and app-specific sharing.

Refresh after access changes. A hidden setting often reflects permissions rather than a broken page.

## The agent cannot complete a task
Ask the agent what stopped it, or turn on **Show the agent's steps** in **Settings → General** to read the latest tool result. Then check:

- Is an [approval](https://docs.opser.com/agents/approvals/) waiting for a decision?
- Does the selected agent have the required [permissions](https://docs.opser.com/workspace/permissions/)?
- Is the relevant [integration](https://docs.opser.com/agents/integrations/) connected to the right account?
- Did the source file upload successfully?
- Are [credits and plan allowances](https://docs.opser.com/billing/plans/) available?

Correct the specific missing dependency, then retry a small step. Changing models does not fix a missing permission or disconnected account.

## A change may have completed twice
After a network error, inspect the target record before repeating a write. A browser interruption does not prove that the server cancelled the operation. Search for an existing task, order, invoice, or message before creating another.

## A scheduled run failed
Open automation history and inspect the run. Check timezone, agent access, connection state, credits, and approvals. Review the existing schedule before creating a replacement that could run in parallel.

## A file cannot be opened or saved
Check the upload result, file format, access to the containing app or folder, and available storage. For a generated file, open its file card in the chat, or turn on the agent's steps to inspect the tool result. Preserve the original when asking the agent to repair or transform a complex file.

## A payment is not reflected
Inspect Billing and the payment provider’s status. Record the payment reference and contact support if the transaction succeeded but your workspace has not updated. Avoid repeated purchases while the original payment is unresolved.

## Get help
Use the [support guide](https://docs.opser.com/help/support/) to include enough context for someone to reproduce the problem without exposing credentials or unrelated private records.