Knowledge base / recovery paths

Troubleshooting

Resolve common Atlas failures by symptom, cause, fix, verification step, and related log pattern.

401 Invalid token

Cause: expired SSO token or missing docs:write scope.

atlas auth refresh

409 Schema conflict

Cause: local docs schema differs from stable channel.

atlas sync --dry-run

Sync timeout

Cause: large media folder or rate-limited API queue.

atlas logs --tail

Permission denied

Cause: workspace role cannot publish stable docs.

atlas workspace roles