v1

latestOpenAPI 3.1.02026-07-241695611.0 MB
Portfolio Monitoring

Create Portfolio Notification Policy

Create a notification policy for the portfolio.

post/portfolio/notification_policies

Request body

typestring required

The type of notification policy (email, slack, webhook).

namestring required

The name of the notification policy.

enabledboolean

Whether the notification policy should be enabled.

cadence'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually' required

The cadence of monitoring.

attributesV1NotifiableAttributes[]

List of attributes to notify on (officers, alternative_names).

recipientsstring[]

List of email recipients for email notification policies.

Example request

{
  "type": "email",
  "attributes": [
    "officers"
  ],
  "recipients": [
    "user@example.com",
    "admin@example.com"
  ]
}

Response

Response

idstring uuid required

The unique identifier of the notification policy.

typestring required

The type of notification policy (email, slack, webhook).

namestring required

The name of the notification policy.

group_idstring uuid nullable

The unique identifier of the portfolio group (if applicable).

item_idstring uuid nullable

The unique identifier of the portfolio item (if applicable).

enabledboolean required

Whether the notification policy is enabled.

cadence'daily' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'biannually' | 'annually' required

The cadence of monitoring.

last_run_atstring date-time nullable

When the notification policy was last executed.

next_run_onstring date nullable

When the notification policy is scheduled to run next.

attributesV1NotifiableAttributes[]

List of attributes to notify on (officers, alternative_names).

recipientsstring[]

List of email recipients for email notification policies.

created_atstring date-time required

When the notification policy was created.

updated_atstring date-time nullable

When the notification policy was last updated.

Example response

{
  "type": "email",
  "attributes": [
    "officers"
  ],
  "recipients": [
    "user@example.com",
    "admin@example.com"
  ]
}