Deprecation Notice: Source Subtype Endpoints in v2025/v2026

Announcements API Deprecations
1

Deprecated Endpoint

The following legacy source subtype endpoints are deprecated in both v2025 and v2026:

  • GET /v2025/sources/subtypes/{subtypeId}
  • GET /v2025/sources/{sourceId}/subtypes/{technicalName}
  • GET /v2025/sources/{sourceId}/subtypes
  • POST /v2025/sources/{sourceId}/subtypes
  • PATCH /v2025/sources/{sourceId}/subtypes/{technicalName}
  • DELETE /v2025/sources/{sourceId}/subtypes/{technicalName}
  • GET /v2026/sources/subtypes/{subtypeId}
  • GET /v2026/sources/{sourceId}/subtypes/{technicalName}
  • GET /v2026/sources/{sourceId}/subtypes
  • POST /v2026/sources/{sourceId}/subtypes
  • PATCH /v2026/sources/{sourceId}/subtypes/{technicalName}
  • DELETE /v2026/sources/{sourceId}/subtypes/{technicalName}

Date Deprecated

2026-06-10

Reason for Deprecation

These endpoints are being deprecated as part of our API modernisation efforts to provide a more consistent and scalable source subtype API experience across supported versions.
The replacement endpoints support the same core use cases with improved consistency for listing, filtering, and subtype lifecycle operations.

Replacement (if any)

Recommended replacement endpoints:

  • GET /v2026/source-subtypes/{subtypeId} (replacement for get-by-id)
  • GET /v2026/source-subtypes?filters=technicalName eq "{technicalName}" and source.id eq "{sourceId}" (replacement for get-by-source+technicalName)
  • GET /v2026/source-subtypes?filters=source.id eq "{sourceId}" (replacement for list-by-source)
  • POST /v2026/source-subtypes (replacement for create)
  • PATCH /v2026/source-subtypes/{subtypeId} (replacement for patch)
  • DELETE /v2026/source-subtypes/{subtypeId} (replacement for delete)

Developer docs link

Deprecation Timeline

  • Deprecated: 2026-06-10
  • Scheduled Removal: 2026-09-08
  • Support End Date (if applicable): N/A

Additional Notes

  • This deprecation applies to legacy source subtype endpoints surfaced via old sources/.../subtypes patterns in both v2025 and v2026.
  • Migration guidance:
      • If you currently read a subtype by {sourceId} + {technicalName}, switch to the filters query on /v2026/source-subtypes.
      • For patch/delete, use {subtypeId} in the new endpoints.