docs(connectors): status error code and how a block clears (PRO-2531) by adityamishra-hydradb · Pull Request #324 · hydra-db/mintlify-docs

adityamishra-hydradb · 2026-10-20T18:04:54Z

FIX : PRO-2531

For humans

Get Connector Status documents error.code and error.failure_class, with a table of what each code means and what to do.
The docs now say how a block clears: a reconnect clears connector and resource blocks, and a successful sync clears a connector block.

The response schema on the page shows the new fields after CI regenerates openapi.json from the app PR hydradb-application PR 2514.

For agents

api-reference/v2/endpoint/get-connector-status.mdx, get-connector.mdx, update-connector.mdx: prose only. openapi.json is not edited by hand.
mintlify validate and mintlify broken-links pass.

🤖 Generated with Claude Code

…ears (PRO-2531) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

…k (PRO-2531) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

mintlify · 2026-10-20T18:04:58Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
cortex-ai	🟢 Ready	View Preview	Oct 22, 2026, 3:19 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

github-actions · 2026-10-20T18:05:11Z

✅ Mintlify Hygiene

No issues found.

openhack-agent · 2026-10-20T18:05:22Z

✅ OpenHack Summary

Security review of docs(connectors): status error code and how a block clears (PRO-2531). 3 changed files; 0 findings at or above the low reporting threshold.

0 0 0 0

Confidence Score: 5/5

No reportable security findings were detected in this scan.

Security merge-readiness rubric: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = no reportable findings. This score reflects scan findings, not a guarantee of correctness or complete coverage.

Files Needing Attention: None

Important Files Changed

api-reference/v2/endpoint/get-connector-status.mdx (modified)
api-reference/v2/endpoint/get-connector.mdx (modified)
api-reference/v2/endpoint/update-connector.mdx (modified)

Last reviewed commit: 7f8c54b · View review on OpenHack

TIP: Mention @openhack-agent in a PR comment to request a review or ask a question. Use @openhack-agent fix all for every finding, or @openhack-agent fix unresolved threads for open review threads only.

openhack-agent

OpenHack reviewed this commit. See the OpenHack Summary for the confidence score and fix actions.

greptile-apps · 2026-10-20T18:08:18Z

Confidence Score: 5/5

[Medium impact] The documentation changes appear safe to merge.

Summary

Documents connector failure codes and recovery steps.

Connector status pages explain failure codes and their next steps.
Reconnects clear connector blocks, while resetting a resource starts its sync over.

Both earlier, unnumbered findings are addressed: the page explains which settings reset and limits the fresh sync to filters.lookback_days. No new actionable issues were found.

_{Reviews (5) · Last reviewed commit: "chore: merge main into pro-2531 docs" · Reviewed by Greptile}

adityamishra-hydradb · 2026-10-20T18:28:58Z

/devin review

devin-ai-integration · 2026-10-20T18:29:11Z

Starting Devin Review.

devin-ai-integration

Note

Newer findings are available below. Devin Review posted a newer report on this PR, in addition to the findings presented here.

Devin Review found 1 potential issue.

…t delete-and-add resets (PRO-2531) Delete and add again resets the resource: the sync position is empty, and routing and custom_instructions that are not sent again change to the connector defaults. Reconnect keeps them, so it is the first step. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

adityamishra-hydradb · 2026-10-20T18:43:31Z

@greptileai review

adityamishra-hydradb · 2026-10-20T18:45:47Z

/devin review

devin-ai-integration · 2026-10-20T18:45:52Z

Starting Devin Review.

devin-ai-integration

Devin Review found 1 new potential issue.

…only the lookback window (PRO-2531) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

adityamishra-hydradb · 2026-10-20T18:57:49Z

@greptileai review

Signed-off-by: bit2swaz <bit2swaz@gmail.com> # Conflicts: # api-reference/v2/endpoint/update-connector.mdx

bit2swaz and others added 2 commits October 20, 2026 00:40

docs(connectors): status error code and failure class, how a block cl…

b81d946

…ears (PRO-2531) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

docs(connectors): apply DOC1 review, block reason, sync clears a bloc…

9d3a8f2

…k (PRO-2531) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

openhack-agent Bot reviewed Oct 20, 2026

View reviewed changes

mintlify Bot deployed to staging October 20, 2026 18:05

View deployment

This comment was marked as resolved.

Sign in to view

devin-ai-integration Bot reviewed Oct 20, 2026

View reviewed changes

Comment thread api-reference/v2/endpoint/get-connector-status.mdx

devin-ai-integration Bot reviewed Oct 20, 2026

View reviewed changes

Comment thread api-reference/v2/endpoint/get-connector-status.mdx Outdated

mintlify Bot deployed to staging October 20, 2026 18:49

View deployment

greptile-apps Bot reviewed Oct 20, 2026

View reviewed changes

Comment thread api-reference/v2/endpoint/get-connector-status.mdx Outdated

docs(connectors): delete-and-add drops the access rule and refetches …

d006a1e

…only the lookback window (PRO-2531) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Signed-off-by: bit2swaz <bit2swaz@gmail.com>

mintlify Bot deployed to staging October 20, 2026 18:57

View deployment

chore: merge main into pro-2531 docs

7f8c54b

Signed-off-by: bit2swaz <bit2swaz@gmail.com> # Conflicts: # api-reference/v2/endpoint/update-connector.mdx

mintlify Bot deployed to staging October 22, 2026 15:19

View deployment

Conversation

adityamishra-hydradb commented Oct 20, 2026 • edited by devin-ai-integration Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

For humans

For agents

Uh oh!

mintlify Bot commented Oct 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Oct 20, 2026

✅ Mintlify Hygiene

Uh oh!

openhack-agent Bot commented Oct 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ OpenHack Summary

Confidence Score: 5/5

Uh oh!

openhack-agent Bot left a comment

Choose a reason for hiding this comment

Uh oh!

greptile-apps Bot commented Oct 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 5/5

Summary

Uh oh!

This comment was marked as resolved.

Uh oh!

adityamishra-hydradb commented Oct 20, 2026

Uh oh!

devin-ai-integration Bot commented Oct 20, 2026

Uh oh!

devin-ai-integration Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

adityamishra-hydradb commented Oct 20, 2026

Uh oh!

adityamishra-hydradb commented Oct 20, 2026

Uh oh!

devin-ai-integration Bot commented Oct 20, 2026

Uh oh!

devin-ai-integration Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

adityamishra-hydradb commented Oct 20, 2026

Uh oh!

This branch was successfully deployed

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

adityamishra-hydradb commented Oct 20, 2026 •

edited by devin-ai-integration Bot

Loading

mintlify Bot commented Oct 20, 2026 •

edited

Loading

openhack-agent Bot commented Oct 20, 2026 •

edited

Loading

greptile-apps Bot commented Oct 20, 2026 •

edited

Loading

devin-ai-integration Bot left a comment •

edited

Loading