Notifications

Get All User Notifications

get

Get notifications for a specific user.

Args:

user (UserProfile): The user profile dependency.
organization (Organization): The organization dependency.
notification_service (NotificationService): The notification service dependency

Returns:

list[UserNotificationBase]: The list of notifications for the user.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Responses

200

Successful Response

application/json

get

/notifications/

HTTPcURLJavaScriptPython

GET /notifications/ HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successful Response

[]

Delete Notification

delete

Delete a notification by its ID.

Args:

notification_id (str): The ID of the notification to delete.
user (UserProfile): The user profile dependency.
notification_service (NotificationService): The notification service dependency
created_at (datetime.datetime): The created at date of the notification.

Returns:

dict: The response indicating the success of the deletion.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

notification_idstring · uuidRequired

Query parameters

created_atstring · date-timeRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

delete

/notifications/{notification_id}

HTTPcURLJavaScriptPython

DELETE /notifications/{notification_id}?created_at=2026-01-29T16%3A05%3A09.739Z HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Update Notification

patch

Update a notification.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

notification_idstring · uuidRequired

Query parameters

created_atstring · date-timeRequired

Body

application/json

read_atstring · date-timeRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

patch

/notifications/{notification_id}

HTTPcURLJavaScriptPython

PATCH /notifications/{notification_id}?created_at=2026-01-29T16%3A05%3A09.739Z HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "read_at": "2026-01-29T16:05:09.739Z"
}

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Delete All User Notifications

delete

Delete all notifications for a specific user.

Args:

user (UserProfile): The user profile dependency.
organization (Organization): The organization dependency
notification_service (NotificationService): The notification service dependency

Returns:

dict: The response indicating the success of the deletion.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Responses

200

Successful Response

application/json

delete

/notifications/all/

HTTPcURLJavaScriptPython

DELETE /notifications/all/ HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

Successful Response

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get Users From Org By Role

post

Get users from organization by role.

Authorizations

OAuth2PasswordBearer

OAuth2passwordRequired

Token URL:

Path parameters

notification_idstring · uuidRequired

Query parameters

role_namestringRequired

Responses

200

Successful Response

application/json

422

Validation Error

application/json

post

/notifications/{notification_id}/

HTTPcURLJavaScriptPython

POST /notifications/{notification_id}/?role_name=text HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}