Skip to content

feat!: rename ListEntitiesInDatasetRequest to ListDatasetEntitiesRequest and change listEntitiesInDataset endpoint path - #26

Merged
oscatcher merged 1 commit into
mainfrom
fern-bot/2026-05-19T12-25-52Z
May 19, 2026
Merged

oscatcher merged 1 commit into
mainfrom
fern-bot/2026-05-19T12-25-52Z

Conversation

@fern-api

@fern-api fern-api Bot commented May 19, 2026

Copy link
Copy Markdown
Contributor

⚠️ 1.5.0 → 2.0.0

Breaking: MAJOR because ListEntitiesInDatasetRequest was removed and replaced by ListDatasetEntitiesRequest, listEntitiesInDataset() changed its HTTP method and path from GET /catchAll/datasets/{id}/entities to POST /catchAll/datasets/{id}/entities/list, and ConnectedEntity.Builder introduced a new mandatory type step — all of which break existing callers at compile time or runtime.

Breaking Changes

  • ListEntitiesInDatasetRequest — renamed to ListDatasetEntitiesRequest; update all imports and usages to the new class name.
  • listEntitiesInDataset() — now sends POST /catchAll/datasets/{id}/entities/list instead of GET /catchAll/datasets/{id}/entities; recompile against the new SDK and update any HTTP-level integrations.
  • ConnectedEntity.Builder — a new mandatory .type(entityType) step is now required between .relation() and .build(); update all existing builder chains accordingly.

Added

  • ConnectedEntity.getType() — returns the entity type string for a connected entity.
  • ConnectedEntity.getCompany() — returns an Optional<CompanyAttributes> with stored company attributes when present.
  • SubmitRequestDto.getEdScoreMin() — new optional ed_score_min field to set a minimum relevance score threshold for Company Watchlist mode results.
  • CreateMonitorRequestDto.getTimezone() — new optional timezone field accepting an IANA timezone identifier used as a fallback when the schedule string lacks an explicit timezone.

Changed

  • addEntitiesToDataset() — now throws UnprocessableEntityError on HTTP 422 responses in addition to the existing NotFoundError on 404.
  • createDataset() / uploadCsvToDataset() documentation — clarifies that both name and domain columns are required in the uploaded CSV (previously only name was documented as required).

Fixed

  • ListDatasetsRequest and ListDatasetEntitiesRequest — getter methods were incorrectly annotated with @JsonIgnore instead of @JsonProperty, causing query parameters (page, page_size, search, etc.) to be silently dropped during serialization; now correctly annotated.

See full changelog

…est and change listEntitiesInDataset endpoint path

The datasets client has been updated to reflect API changes: the request
type for listing entities in a dataset has been renamed from
`ListEntitiesInDatasetRequest` to `ListDatasetEntitiesRequest`, and the
underlying HTTP endpoint path has changed from `entities` to
`entities/list` (now a POST instead of GET). The method ordering in the
client has also been reorganized so that `addEntitiesToDataset` and
`removeEntitiesFromDataset` appear before `listEntitiesInDataset`.

Key changes:
- `ListEntitiesInDatasetRequest` renamed to `ListDatasetEntitiesRequest`; callers must update their import and usage
- `listEntitiesInDataset` now hits `POST /catchAll/datasets/{id}/entities/list` instead of `GET /catchAll/datasets/{id}/entities`
- `addEntitiesToDataset` now throws `UnprocessableEntityError` (HTTP 422) in addition to existing error types
- Javadoc updated to note that both `name` and `domain` columns are required in CSV uploads (previously only `name`)

🌿 Generated with Fern
@oscatcher
oscatcher self-requested a review May 19, 2026 12:30

@oscatcher oscatcher left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@oscatcher
oscatcher merged commit 4bf57ec into main May 19, 2026
3 checks passed
@oscatcher
oscatcher deleted the fern-bot/2026-05-19T12-25-52Z branch May 19, 2026 12:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant