---
title: "FilterStudioSubscriptions filters studio subscription by event details"
method: POST
path: "/studioSubscriptions:filter"
---

# FilterStudioSubscriptions filters studio subscription by event details

`POST /studioSubscriptions:filter`

Filters Studio subscriptions by target entity, specific event, user who subscribed, and time subscribed

## Headers

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

## Request body

- V1FilterStudioSubscriptionsRequest — The request body of the filter studio subscriptions call.
  - `query` V1StudioSubscriptionsQuery — The query required to perform a filter studio subscription 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.

- V1FilterStudioSubscriptionsResponse — The response for filter studio subscriptions method.
  - `studioSubscriptions` V1StudioSubscription[], required — The studio subscription entities that match the specified respective filter request.
    - `id` string
    - `user` 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
    - `studioNotificationAction` 'STUDIO_NOTIFICATION_ACTION_UNSPECIFIED' | 'STUDIO_NOTIFICATION_ACTION_SMTP' | 'STUDIO_NOTIFICATION_ACTION_PUSH' — - STUDIO_NOTIFICATION_ACTION_UNSPECIFIED: Unspecified - STUDIO_NOTIFICATION_ACTION_SMTP: Email notification - STUDIO_NOTIFICATION_ACTION_PUSH: Studio UI push notification
    - `email` string
    - `creationDateTime` string, date-time
  - `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-subscription.md) · [All operations](https://skmtc.dev/blackrock/apis/studio-notification-subscription/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blackrock/studio-notification-subscription/revisions/f4bac79cc339/schema)