Fix GET /data_connectors/{id}: correct schema to use present_detail fields

[salmanbshah]

Why?

The original documentation for GET /data_connectors/{id} (merged in PR #403) used the wrong response schema — it reflected the list-view fields from DataConnectorPresenter.present rather than the richer present_detail that the show action actually calls. Ellice Nelson flagged this: "The schema updates here don't match the fields returned." Customers relying on the docs to build against this endpoint would see fields like data_inputs, response_fields, and object_mappings in real responses that are completely absent from the spec.

How?

Corrected the path entry to reference a new data_connector_detail schema that matches DataConnectorPresenter.present_detail exactly, and added the optional state_version query parameter (live/draft) that the controller supports.

Decisions

• New data_connector_detail schema rather than patching the existing data_connector schema — the list endpoint uses the simpler fields intentionally and should stay lightweight.

Implementation Plan

Fix data_connectors schema + Surgical developer-docs PR

Context

PR #778 is wrong — it replaces the entire developer-docs Unstable YAML with the Intercom-OpenAPI copy, causing a +1260/-1400 diff with hundreds of unrelated deletions. The two repos were NEVER true mirrors (2033 lines of diff across 123 chunks before our work). PR #777 also made a huge reformat (+2201/-3249) that #778 predates.

The correct approach: add ONLY the 3 missing path entries surgically to the developer-docs YAML (fin_voice was already added by #777).

Confirmed Gaps

Controller	Missing Endpoints
api/v3/data_connectors_controller.rb	GET /data_connectors/{id} — schema wrong, needs present_detail fields
api/v3/conversation_parts_controller.rb	PUT /conversations/{conversation_id}/conversation_parts/{id}
api/v3/messages_controller.rb	GET /messages/whatsapp/status

Backend References

• Controller: https://github.com/intercom/intercom/blob/master/app/controllers/api/v3/data_connectors_controller.rb
• Presenter: https://github.com/intercom/intercom/blob/master/app/presenters/api/v3/data_connectors/data_connector_presenter.rb

_{Generated with Claude Code}

[ellicenelson]

Is there a corresponding developer-docs PR for these changes?

Also this may conflict with new changes on main.

[ellicenelson]

The function of state_version is still behind a feature flag and is not yet rolled out. This (and the corresponding 400) should be excluded until that change has GA

[ellicenelson]

These can be consolidated with the existing data connectors changelog entry and can avoid traces of "missing" and "fixed" since this is expected in the Unstable version

[ellicenelson]

Same here

[salmanbshah]

Thanks Ellice! I've removed the parameter and the 400 response (feature flag not yet GA), and consolidated the changelog entry.

[salmanbshah]

Separate developer-docs PR created for the data connectors show endpoint: https://github.com/intercom/developer-docs/pull/781

[ellicenelson]

The changelog convention actually lives in developer-docs. I'd actually drop this file and keep changelog entries in developer-docs only for consistency