---
title: "FilterStudioNotifications filters studio notifications by event details"
method: POST
path: "/studioNotifications:filter"
---

# FilterStudioNotifications filters studio notifications by event details

`POST /studioNotifications:filter`

Filters studio notifications by target entity, specific event, recipient, and time sent

## Headers

- `VND.com.blackrock.Request-ID` string, UUID, required
- `VND.com.blackrock.Origin-Timestamp` string, date-time, required

## Request body

- V1FilterStudioNotificationsRequest — The request body of the filter studio notifications call.
  - `query` V1StudioNotificationQuery — The query required to perform a filter studio notifications call.
    - `studioEntityType` 'STUDIO_ENTITY_TYPE_UNSPECIFIED' | 'STUDIO_ENTITY_TYPE_USER' | 'STUDIO_ENTITY_TYPE_PROJECT' | 'STUDIO_ENTITY_TYPE_SPACE' — - STUDIO_ENTITY_TYPE_UNSPECIFIED: Unspecified - STUDIO_ENTITY_TYPE_USER: User - STUDIO_ENTITY_TYPE_PROJECT: Project - STUDIO_ENTITY_TYPE_SPACE: Space
    - `studioEntityName` string
    - `studioNotificationEventType` 'STUDIO_NOTIFICATION_EVENT_TYPE_UNSPECIFIED' | 'STUDIO_NOTIFICATION_EVENT_TYPE_ACM' | 'STUDIO_NOTIFICATION_EVENT_TYPE_COMPUTE' | 'STUDIO_NOTIFICATION_EVENT_TYPE_API' | 'STUDIO_NOTIFICATION_EVENT_TYPE_SPACE' | 'STUDIO_NOTIFICATION_EVENT_TYPE_PROJECT' — - STUDIO_NOTIFICATION_EVENT_TYPE_UNSPECIFIED: Unspecified - STUDIO_NOTIFICATION_EVENT_TYPE_ACM: Aladdin Credit Management - STUDIO_NOTIFICATION_EVENT_TYPE_COMPUTE: Studio Compute - STUDIO_NOTIFICATION_EVENT_TYPE_API: API Applications - STUDIO_NOTIFICATION_EVENT_TYPE_SPACE: Studio Space - STUDIO_NOTIFICATION_EVENT_TYPE_PROJECT: Studio Project
    - `studioNotificationEventName` string
    - `userId` string
    - `dateRangeFilter` V1RangeFilter
      - `startDate` string, date
      - `endDate` string, date
  - `pageToken` string — The starting point of a query result.
  - `pageSize` integer — The maximum number of studio notifications to be returned per page of results. The maximum allowed page size is 1000. Default is 100 if empty or a number < 1 is specified.

## Response `200`

A successful response.

- V1FilterStudioNotificationsResponse
  - `studioNotifications` V1StudioNotification[], required — The studio notification entities that match the specified respective filter request.
    - `id` string
    - `studioNotificationEvent` V1StudioNotificationEvent
      - `studioNotificationEventType` 'STUDIO_NOTIFICATION_EVENT_TYPE_UNSPECIFIED' | 'STUDIO_NOTIFICATION_EVENT_TYPE_ACM' | 'STUDIO_NOTIFICATION_EVENT_TYPE_COMPUTE' | 'STUDIO_NOTIFICATION_EVENT_TYPE_API' | 'STUDIO_NOTIFICATION_EVENT_TYPE_SPACE' | 'STUDIO_NOTIFICATION_EVENT_TYPE_PROJECT' — - STUDIO_NOTIFICATION_EVENT_TYPE_UNSPECIFIED: Unspecified - STUDIO_NOTIFICATION_EVENT_TYPE_ACM: Aladdin Credit Management - STUDIO_NOTIFICATION_EVENT_TYPE_COMPUTE: Studio Compute - STUDIO_NOTIFICATION_EVENT_TYPE_API: API Applications - STUDIO_NOTIFICATION_EVENT_TYPE_SPACE: Studio Space - STUDIO_NOTIFICATION_EVENT_TYPE_PROJECT: Studio Project
      - `eventName` string
    - `studioNotificationScope` V1StudioNotificationScope
      - `studioEntityType` 'STUDIO_ENTITY_TYPE_UNSPECIFIED' | 'STUDIO_ENTITY_TYPE_USER' | 'STUDIO_ENTITY_TYPE_PROJECT' | 'STUDIO_ENTITY_TYPE_SPACE' — - STUDIO_ENTITY_TYPE_UNSPECIFIED: Unspecified - STUDIO_ENTITY_TYPE_USER: User - STUDIO_ENTITY_TYPE_PROJECT: Project - STUDIO_ENTITY_TYPE_SPACE: Space
      - `studioEntityName` string
    - `sender` string
    - `notificationSubject` string
    - `notificationMessage` string
    - `creationDateTime` string, date-time
    - `notificationMetadata` object
    - `studioRecipientScopes` V1StudioRecipientScope[]
      - `studioRecipientId` string
      - `studioRecipientType` 'STUDIO_RECIPIENT_TYPE_UNSPECIFIED' | 'STUDIO_RECIPIENT_TYPE_USER' | 'STUDIO_RECIPIENT_TYPE_EMAIL' | 'STUDIO_RECIPIENT_TYPE_PROJECT' | 'STUDIO_RECIPIENT_TYPE_SPACE' | 'STUDIO_RECIPIENT_TYPE_PERM' — - STUDIO_RECIPIENT_TYPE_UNSPECIFIED: Unspecified - STUDIO_RECIPIENT_TYPE_USER: User - STUDIO_RECIPIENT_TYPE_EMAIL: Email - STUDIO_RECIPIENT_TYPE_PROJECT: Project - STUDIO_RECIPIENT_TYPE_SPACE: Space - STUDIO_RECIPIENT_TYPE_PERM: PERMS
      - `studioRecipientAccessType` string
  - `nextPageToken` string — A token to retrieve the next page of results.

## Other responses

- `400` — Aladdin® will not process the request due to an apparent client error.
- `401` — Aladdin® will not process the request as the necessary credentials were not provided or were invalid.
- `403` — Aladdin® understood the request but is refusing to authorize it.
- `404` — Aladdin® did not find the resource requested or is unwilling to disclose if it exists. Could indicate a defect in the client program or data which is no longer accessible.

---

[API](https://skmtc.dev/blackrock/apis/studio-notification.md) · [All operations](https://skmtc.dev/blackrock/apis/studio-notification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blackrock/studio-notification/revisions/b59b8a2506f2/schema)