List evidence suggested for ideas

Request

Unassigned, non-declined evidence. Each item carries suggested_for_idea_ids, the ideas the ML suggests it for, strongest first. With ideaIds, only evidence suggested for those ideas is returned and suggested_for_idea_ids lists the requested ideas it is suggested for; without, every unassigned evidence is returned and suggested_for_idea_ids may be empty. Ordered by the evidence sort, not by match rank. ideaId, status and state are ignored. There is no total; page until hasMore is false.

Security

ApiToken

Query

ideaIdsArray of strings, <= 50 items

Restrict to these ideas (Bagel ObjectIds), at most 50.

idsArray of strings

Filter by evidence IDs (Bagel ObjectIds).

Example:ids=5f8d0d55b54764421b7156c3&ids=5f8d0d55b54764421b7156c4

componentIdstring^[0-9a-fA-F]{24}$

Filter by product component (Bagel ObjectId).

ownerIdstring^[0-9a-fA-F]{24}$

Filter by evidence owner (Bagel user ObjectId).

orgIdstring^[0-9a-fA-F]{24}$

Filter by linked company/organization (Bagel ObjectId).

originstring

Filter by the source system the evidence originated from.

Example:origin=salesforce

originIdsArray of strings

Filter by evidence IDs in the source system (the origin_id field).

Example:originIds=SFOpporunityId-123&originIds=SFOpporunityId-456

businessNamestring

Filter by business name.

createdAtStartstring, (date-time)

Return evidence created on or after this ISO 8601 date-time (inclusive).

Example:createdAtStart=2024-12-01T00:00:00.000Z

createdAtEndstring, (date-time)

Return evidence created on or before this ISO 8601 date-time (inclusive).

Example:createdAtEnd=2024-12-26T00:00:00.000Z

updatedAtStartstring, (date-time)

Return evidence updated on or after this ISO 8601 date-time (inclusive).

Example:updatedAtStart=2024-12-01T00:00:00.000Z

updatedAtEndstring, (date-time)

Return evidence updated on or before this ISO 8601 date-time (inclusive).

Example:updatedAtEnd=2024-12-26T00:00:00.000Z

pageinteger, >= 1

Default:1

pageSizeinteger, [ 1 .. 1000 ]

Default:500

sortBystring

Field to sort by.

Default:"createdAt"

sortDirstring

Sort direction.

Default:"desc"

Enum:"asc""desc"

curl -i -X GET \
  'https://api.bagel.ai/v2/suggested-evidences?ideaIds=string&ids=5f8d0d55b54764421b7156c3%2C5f8d0d55b54764421b7156c4&componentId=string&ownerId=string&orgId=string&origin=salesforce&originIds=SFOpporunityId-123%2CSFOpporunityId-456&businessName=string&createdAtStart=2024-12-01T00%3A00%3A00.000Z&createdAtEnd=2024-12-26T00%3A00%3A00.000Z&updatedAtStart=2024-12-01T00%3A00%3A00.000Z&updatedAtEnd=2024-12-26T00%3A00%3A00.000Z&page=1&pageSize=500&sortBy=createdAt&sortDir=asc' \
  -H 'authorization: YOUR_API_KEY_HERE'

Responses

A page of evidence

Bodyapplication/json

itemsArray of objects(ApiEvidence)

hasMoreboolean

Example:false

Response

{
  "items": [
    { … }
  ],
  "hasMore": false
}