Skip to content

Repository / Persistence Failure

URI: https://docs.ankatech.co/errors/repository
HTTP Status: 500 Internal Server Error

When you see this

An unexpected error occurred while accessing or updating the underlying data store. Although your request was valid, the server could not complete the operation due to a repository or I/O problem.

Common Causes

  • The database is temporarily unavailable or unreachable.
  • A transaction failed or was rolled back due to a deadlock or constraint violation.
  • The keystore or metadata store is corrupted or in an inconsistent state.
  • An error occurred serializing or deserializing the resource (e.g. malformed JSON in the store).

How to Resolve

  1. Check the response detail for any low-level message indicating the root cause.
  2. Retry the request after a brief wait—intermittent database or network issues often self-heal.
  3. If the error persists, verify the health of your persistence layer (database, key store).
  4. Consult your operations or DevOps team to investigate logs and metrics for the data store.

If you continue to receive a 500 error after these steps, please consult the full API Reference.