--- title: "PortfolioItem.updated" method: POST path: "PortfolioItem.updated" tags: ["Portfolio Monitoring", "Webhook Events"] --- # PortfolioItem.updated `POST PortfolioItem.updated` (webhook) Emitted when a portfolio item has been updated. ## Payload - V1PortfolioItemUpdatedWebhook - `root` union, required — The webhook payload data - V1BusinessPortfolioItemResponse — Represents a business portfolio item - `id` string, uuid, required — The unique identifier of the portfolio item. - `search_id` string, uuid, required — The unique identifier of the search that the portfolio item is based on. - `name` string, required — The name of the portfolio item. - `group_id` string, uuid, nullable — The UUID of the portfolio group that the item belongs to. - `user` V1UserAttributionResponse — Response model for user attribution operations. This model defines the structure for user attribution API responses. - `id` string, uuid, required — Unique identifier for the user. - `first_name` string, required — First name of the user. - `last_name` string, required — Last name of the user. - `email` string, required — Email address of the user. - `comments` V1PortfolioItemCommentResponse[] - `id` string, uuid, required — The UUID of the comment. - `text` string, required — The text of the comment. - `user` V1UserAttributionResponse, required — Response model for user attribution operations. This model defines the structure for user attribution API responses. - `id` string, uuid, required — Unique identifier for the user. - `first_name` string, required — First name of the user. - `last_name` string, required — Last name of the user. - `email` string, required — Email address of the user. - `item_id` string, uuid, required — The UUID of the portfolio item that the comment is associated with. - `created_at` string, date-time, required — The timestamp of when the comment was made. - `attachments` V1AttachmentResponseModel[] - `id` string, uuid, required — The UUID of the attachment. - `name` string, required — The name of the attachment. - `user` V1UserAttributionResponse — Response model for user attribution operations. This model defines the structure for user attribution API responses. - `id` string, uuid, required — Unique identifier for the user. - `first_name` string, required — First name of the user. - `last_name` string, required — Last name of the user. - `email` string, required — Email address of the user. - `item_id` string, uuid, required — The UUID of the portfolio item that the attachment is associated with. - `created_at` string, date-time, required — The timestamp of when the attachment was uploaded. - `redirect_url` string, required - `scores` V1ScoreResponse[] - `type` 'fraud' | 'risk' | 'kyb', required - `score` number, required — The score value. - `rating` string, required — The rating associated with the score. - `created_at` string, date-time, required — The timestamp of when the portfolio item was created. - `last_monitored_at` string, date-time, nullable — The timestamp of when the portfolio item was last monitored. - `type` 'Business', required — The type of the portfolio item. - `business` V1BusinessSummaryResponse, required — Response model for business summary data. - `id` string, uuid, required — Unique identifier for the business. - `name` string, required — The name of the business, determined by the name found on the domestic registration. - `address` string, nullable — The primary address associated with the business entity. - `phone_number` string, nullable — The primary phone number found associated with the business. - `email` string, nullable — The primary email address found associated with the business. - `website` string, nullable — The primary website found associated with the business. - `url` string, uri — The URL to the business details. - `console_url` string, uri — The URL to the business details in the console. - V1PersonPortfolioItemResponse — Represents a person portfolio item - `id` string, uuid, required — The unique identifier of the portfolio item. - `search_id` string, uuid, required — The unique identifier of the search that the portfolio item is based on. - `name` string, required — The name of the portfolio item. - `group_id` string, uuid, nullable — The UUID of the portfolio group that the item belongs to. - `user` V1UserAttributionResponse — Response model for user attribution operations. This model defines the structure for user attribution API responses. - `id` string, uuid, required — Unique identifier for the user. - `first_name` string, required — First name of the user. - `last_name` string, required — Last name of the user. - `email` string, required — Email address of the user. - `comments` V1PortfolioItemCommentResponse[] - `id` string, uuid, required — The UUID of the comment. - `text` string, required — The text of the comment. - `user` V1UserAttributionResponse, required — Response model for user attribution operations. This model defines the structure for user attribution API responses. - `id` string, uuid, required — Unique identifier for the user. - `first_name` string, required — First name of the user. - `last_name` string, required — Last name of the user. - `email` string, required — Email address of the user. - `item_id` string, uuid, required — The UUID of the portfolio item that the comment is associated with. - `created_at` string, date-time, required — The timestamp of when the comment was made. - `attachments` V1AttachmentResponseModel[] - `id` string, uuid, required — The UUID of the attachment. - `name` string, required — The name of the attachment. - `user` V1UserAttributionResponse — Response model for user attribution operations. This model defines the structure for user attribution API responses. - `id` string, uuid, required — Unique identifier for the user. - `first_name` string, required — First name of the user. - `last_name` string, required — Last name of the user. - `email` string, required — Email address of the user. - `item_id` string, uuid, required — The UUID of the portfolio item that the attachment is associated with. - `created_at` string, date-time, required — The timestamp of when the attachment was uploaded. - `redirect_url` string, required - `scores` V1ScoreResponse[] - `type` 'fraud' | 'risk' | 'kyb', required - `score` number, required — The score value. - `rating` string, required — The rating associated with the score. - `created_at` string, date-time, required — The timestamp of when the portfolio item was created. - `last_monitored_at` string, date-time, nullable — The timestamp of when the portfolio item was last monitored. - `type` 'Person', required — The type of the portfolio item. - `person` V1PersonSummaryResponse, required - `id` string, uuid, required — The unique identifier of the person - `first_name` string, required — The first name of the person - `last_name` string, required — The last name of the person - `ssn` string, required — The social security number of the person - `middle_name` string, nullable — The middle name of the person - `suffix` string, nullable — The suffix of the person - `title` string, nullable — The title of the person - `created_at` string, date-time, required — When the person record was created - `updated_at` string, date-time, nullable — When the person record was last updated - `__event__` WebhookMetadata - `type` 'BusinessSearch.submitted' | 'BusinessSearch.responded' | 'BusinessSearch.completed' | 'BusinessSearch.failed' | 'BusinessSearch.cancelled' | 'BusinessSearch.updated' | 'PersonSearch.submitted' | 'PersonSearch.completed' | 'PersonSearch.failed' | 'PersonSearch.updated' | 'DMFSearch.submitted' | 'DMFSearch.completed' | 'DMFSearch.failed' | 'LiensSearch.submitted' | 'LiensSearch.completed' | 'LiensSearch.failed' | 'LienFiling.created' | 'LienFiling.updated' | 'LienFiling.deleted' | 'DocketSearch.submitted' | 'DocketSearch.completed' | 'DocketSearch.failed' | 'DocketDetailsSearch.submitted' | 'DocketDetailsSearch.completed' | 'DocketDetailsSearch.failed' | 'DocketExhibitSearch.submitted' | 'DocketExhibitSearch.completed' | 'DocketExhibitSearch.failed' | 'APIKey.created' | 'APIKey.deleted' | 'OnboardingSession.completed' | 'Order.created' | 'RegistrationEnrichment.submitted' | 'RegistrationEnrichment.completed' | 'RegistrationEnrichment.failed' | 'NAICSPredictionRequest.submitted' | 'NAICSPredictionRequest.completed' | 'NAICSPredictionRequest.failed' | 'WebsiteAnalysisRequest.submitted' | 'WebsiteAnalysisRequest.completed' | 'WebsiteAnalysisRequest.failed' | 'WebPresenceRequest.submitted' | 'WebPresenceRequest.completed' | 'WebPresenceRequest.failed' | 'PortfolioItem.created' | 'PortfolioItem.updated' | 'PortfolioItem.deleted' | 'PortfolioGroup.created' | 'PortfolioGroup.updated' | 'PortfolioGroup.deleted' | 'TINVerification.submitted' | 'TINVerification.completed' | 'TINVerification.failed' | 'AdverseMediaSearch.submitted' | 'AdverseMediaSearch.completed' | 'AdverseMediaSearch.failed' | 'EmployeeVerificationRequest.submitted' | 'EmployeeVerificationRequest.completed' | 'EmployeeVerificationRequest.failed' | 'InternationalBusinessSearch.submitted' | 'InternationalBusinessSearch.completed' | 'InternationalBusinessSearch.failed', required — The canonical list of supported Webhook events. Every Webhook event sent via the notifier must be registered here. An exhaustive match is used against this enumeration to ensure that all events are valid and have corresponding rendering logic. @see WebhookNotifier.render_payload - `origin` 'api' | 'console' | 'mcp' | 'onboarding' - `organization_id` string, nullable - `application_id` string, nullable - `external_id` string, nullable - `application_type` string, nullable ## Acknowledgement `200` Successful Response - unknown ## Other responses - `422` — Validation Error --- [API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/revisions/0cc89938bc26/schema)