v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Portfolio Monitoring

Create Portfolio Items Bulk

Create Business portfolio items for many completed searches.

Request-level authorization and group lookup failures still fail the full request. Per-search failures are returned in errors so the caller can add every eligible row from a checkbox selection without retrying successful rows.

Bulk success and error rows are intentionally lightweight. The frontend only needs IDs and stable error codes for row correlation, cache refreshes, and summary toasts, so the endpoint avoids full PortfolioItem serialization and verbose per-row errors.

post/portfolio/items/bulk

Request body

business_search_idsstring[] required

The UUIDs of the business searches to add to portfolio monitoring.

group_idstring uuid nullable

The optional UUID of the group to add the newly created items to.

Example request

{
  "business_search_ids": [
    "ede786f3-33ae-4894-843d-af2025f1d5b0",
    "e1d5e9e1-6de2-46c0-8492-564998a7426a"
  ],
  "group_id": "ede786f3-33ae-4894-843d-af2025f1d5b0"
}

Response

Successful Response