Release v1.157.0 - release → staging

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [2026-01-12] - v0.155.0
+
+
+### Added:
+
+- `Akamai Cloud Pulse Logs LKE-E Audit ` to the `AccountCapability` type ([#13171](https://github.com/linode/manager/pull/13171))
+
+### Changed:
+
+- Use v4beta endpoints for /events and /events/<eventId> ([#13084](https://github.com/linode/manager/pull/13084))
+- Renamed updated_at, created_at to updated,created in NotificationChannelBase interface ([#13193](https://github.com/linode/manager/pull/13193))
+- Updated getDatabaseConnectionPools signature to accept params for pagination ([#13195](https://github.com/linode/manager/pull/13195))
+- AlertNotificationType from `custom | default` to `user | system`  ([#13203](https://github.com/linode/manager/pull/13203))
+- ACLP-Alerting: Notification Channel types to support API changes and backward compatibility  ([#13227](https://github.com/linode/manager/pull/13227))
+- Move to `v4 endpoint` instead of v4beta for `CloudPulse metrics` api calls ([#13239](https://github.com/linode/manager/pull/13239))
+
+### Upcoming Features:
+
+- Add new API endpoints and types for Resource Locking feature(RESPROT2) ([#13187](https://github.com/linode/manager/pull/13187))
+- Change range property of IPv6SLAAC to be optional ([#13209](https://github.com/linode/manager/pull/13209))
+- Add API endpoints for `Marketplace` ([#13215](https://github.com/linode/manager/pull/13215))
+- CloudPulse-Alerts: Add `CreateNotificationChannelPayload` in types.ts and add request function `createNotificationChannel` in alerts.ts ([#13225](https://github.com/linode/manager/pull/13225))
+- CloudPulse-Alerts: Add type for edition of notification channel payload ([#13235](https://github.com/linode/manager/pull/13235))
+
 ## [2025-12-16] - v0.154.1
 
 

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.154.1",
+  "version": "0.155.0",
   "homepage": "https://github.com/linode/manager/tree/develop/packages/api-v4",
   "bugs": {
     "url": "https://github.com/linode/manager/issues"

packages/api-v4/src/account/events.ts

@@ -1,4 +1,4 @@
-import { API_ROOT } from '../constants';
+import { API_ROOT, BETA_API_ROOT } from '../constants';
 import Request, { setMethod, setParams, setURL, setXFilter } from '../request';
 
 import type { Filter, Params, ResourcePage } from '../types';
@@ -12,7 +12,7 @@ import type { Event, Notification } from './types';
  */
 export const getEvents = (params: Params = {}, filter: Filter = {}) =>
   Request<ResourcePage<Event>>(
-    setURL(`${API_ROOT}/account/events`),
+    setURL(`${BETA_API_ROOT}/account/events`),
     setMethod('GET'),
     setXFilter(filter),
     setParams(params),
@@ -26,7 +26,7 @@ export const getEvents = (params: Params = {}, filter: Filter = {}) =>
  */
 export const getEvent = (eventId: number) =>
   Request<Event>(
-    setURL(`${API_ROOT}/account/events/${encodeURIComponent(eventId)}`),
+    setURL(`${BETA_API_ROOT}/account/events/${encodeURIComponent(eventId)}`),
     setMethod('GET'),
   );
 

packages/api-v4/src/cloudpulse/alerts.ts

@@ -1,6 +1,8 @@
 import {
   createAlertDefinitionSchema,
+  createNotificationChannelPayloadSchema,
   editAlertDefinitionSchema,
+  editNotificationChannelPayloadSchema,
 } from '@linode/validation';
 
 import { BETA_API_ROOT as API_ROOT } from '../constants';
@@ -17,7 +19,9 @@ import type {
   Alert,
   CloudPulseAlertsPayload,
   CreateAlertDefinitionPayload,
+  CreateNotificationChannelPayload,
   EditAlertDefinitionPayload,
+  EditNotificationChannelPayload,
   NotificationChannel,
 } from './types';
 
@@ -139,3 +143,32 @@ export const updateServiceAlerts = (
     setMethod('PUT'),
     setData(payload),
   );
+
+export const createNotificationChannel = (
+  data: CreateNotificationChannelPayload,
+) =>
+  Request<NotificationChannel>(
+    setURL(`${API_ROOT}/monitor/alert-channels`),
+    setMethod('POST'),
+    setData(data, createNotificationChannelPayloadSchema),
+  );
+
+export const getNotificationChannelById = (channelId: number) =>
+  Request<NotificationChannel>(
+    setURL(
+      `${API_ROOT}/monitor/alert-channels/${encodeURIComponent(channelId)}`,
+    ),
+    setMethod('GET'),
+  );
+
+export const updateNotificationChannel = (
+  channelId: number,
+  data: EditNotificationChannelPayload,
+) =>
+  Request<NotificationChannel>(
+    setURL(
+      `${API_ROOT}/monitor/alert-channels/${encodeURIComponent(channelId)}`,
+    ),
+    setMethod('PUT'),
+    setData(data, editNotificationChannelPayloadSchema),
+  );

packages/api-v4/src/cloudpulse/dashboards.ts

@@ -1,4 +1,4 @@
-import { BETA_API_ROOT as API_ROOT } from 'src/constants';
+import { API_ROOT } from 'src/constants';
 
 import Request, { setMethod, setURL } from '../request';
 

packages/api-v4/src/cloudpulse/services.ts

@@ -1,4 +1,4 @@
-import { BETA_API_ROOT as API_ROOT } from 'src/constants';
+import { API_ROOT } from 'src/constants';
 
 import Request, {
   setData,

packages/api-v4/src/cloudpulse/types.ts

@@ -41,11 +41,16 @@ export type MetricUnitType =
   | 'second';
 export type NotificationStatus = 'Disabled' | 'Enabled';
 export type ChannelType = 'email' | 'pagerduty' | 'slack' | 'webhook';
-export type AlertNotificationType = 'custom' | 'default';
+export type AlertNotificationType = 'system' | 'user';
 type AlertNotificationEmail = 'email';
 type AlertNotificationSlack = 'slack';
 type AlertNotificationPagerDuty = 'pagerduty';
 type AlertNotificationWebHook = 'webhook';
+type EmailRecipientType =
+  | 'admin_users'
+  | 'read_users'
+  | 'read_write_users'
+  | 'user';
 export interface Dashboard {
   created: string;
   group_by?: string[];
@@ -277,50 +282,68 @@ export interface Alert {
   updated_by: string;
 }
 
-interface NotificationChannelAlerts {
-  id: number;
-  label: string;
+interface NotificationChannelAlertInfo {
+  alert_count: number;
   type: 'alerts-definitions';
   url: string;
 }
 interface NotificationChannelBase {
-  alerts: NotificationChannelAlerts[];
+  alerts: NotificationChannelAlertInfo;
   channel_type: ChannelType;
-  created_at: string;
+  created: string;
   created_by: string;
   id: number;
   label: string;
   status: NotificationStatus;
   type: AlertNotificationType;
-  updated_at: string;
+  updated: string;
   updated_by: string;
 }
 
 interface NotificationChannelEmail extends NotificationChannelBase {
   channel_type: AlertNotificationEmail;
-  content: {
+  content?: {
     email: {
       email_addresses: string[];
       message: string;
       subject: string;
     };
   };
+  details?: {
+    email: {
+      recipient_type: EmailRecipientType;
+      usernames: string[];
+    };
+  };
 }
 
 interface NotificationChannelSlack extends NotificationChannelBase {
   channel_type: AlertNotificationSlack;
-  content: {
+  content?: {
     slack: {
       message: string;
       slack_channel: string;
       slack_webhook_url: string;
     };
   };
+  details?: {
+    slack: {
+      slack_channel: string;
+      slack_webhook_url: string;
+    };
+  };
 }
 
 interface NotificationChannelPagerDuty extends NotificationChannelBase {
   channel_type: AlertNotificationPagerDuty;
-  content: {
+  content?: {
+    pagerduty: {
+      attributes: string[];
+      description: string;
+      service_api_key: string;
+    };
+  };
+  details?: {
     pagerduty: {
       attributes: string[];
       description: string;
@@ -330,12 +353,27 @@ interface NotificationChannelPagerDuty extends NotificationChannelBase {
 }
 interface NotificationChannelWebHook extends NotificationChannelBase {
   channel_type: AlertNotificationWebHook;
-  content: {
+  content?: {
+    webhook: {
+      http_headers: {
+        header_key: string;
+        header_value: string;
+      }[];
+      webhook_url: string;
+    };
+  };
+  details?: {
     webhook: {
+      alert_body: {
+        body: string;
+        subject: string;
+      };
       http_headers: {
         header_key: string;
         header_value: string;
       }[];
+      method: 'GET' | 'POST' | 'PUT';
+      request_body: string;
       webhook_url: string;
     };
   };
@@ -411,3 +449,43 @@ export interface CloudPulseAlertsPayload {
    */
   user_alerts?: number[];
 }
+
+interface EmailDetail {
+  email: {
+    usernames: string[];
+  };
+}
+
+export interface CreateNotificationChannelPayload {
+  /**
+   * The type of channel to create.
+   */
+  channel_type: ChannelType;
+  /**
+   * The details of the channel to create.
+   */
+  details: EmailDetail;
+  /**
+   * The label of the channel to create.
+   */
+  label: string;
+}
+
+export interface EditNotificationChannelPayload {
+  /**
+   * The details of the channel to edit.
+   */
+  details: EmailDetail;
+  /**
+   * The label of the channel to edit.
+   */
+  label: string;
+}
+
+export interface EditNotificationChannelPayloadWithId
+  extends EditNotificationChannelPayload {
+  /**
+   * The ID of the channel to edit.
+   */
+  channelId: number;
+}

packages/api-v4/src/databases/databases.ts

@@ -371,12 +371,16 @@ export const getDatabaseEngineConfig = (engine: Engine) =>
 /**
  * Get a paginated list of connection pools for a database
  */
-export const getDatabaseConnectionPools = (databaseID: number) =>
+export const getDatabaseConnectionPools = (
+  databaseID: number,
+  params?: Params,
+) =>
   Request<Page<ConnectionPool>>(
     setURL(
       `${API_ROOT}/databases/postgresql/instances/${encodeURIComponent(databaseID)}/connection-pools`,
     ),
     setMethod('GET'),
+    setParams(params),
   );
 
 /**

packages/api-v4/src/index.ts

@@ -24,10 +24,14 @@ export * from './kubernetes';
 
 export * from './linodes';
 
+export * from './locks';
+
 export * from './longview';
 
 export * from './managed';
 
+export * from './marketplace';
+
 export * from './netloadbalancers';
 
 export * from './network-transfer';

packages/api-v4/src/linodes/types.ts

@@ -192,7 +192,7 @@ export interface ConfigInterfaceIPv4 {
 
 export interface IPv6SLAAC {
   address?: string;
-  range: string;
+  range?: string;
 }
 
 // The legacy interface type - for Configuration Profile Interfaces

packages/api-v4/src/locks/index.ts

@@ -0,0 +1,3 @@
+export * from './locks';
+
+export * from './types';