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
OAuth2passwordRequired
Token URL:
Responses
200

Successful Response

application/json
get
/notifications/
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
OAuth2passwordRequired
Token URL:
Path parameters
notification_idstring · uuidRequired
Query parameters
created_atstring · date-timeRequired
Responses
200

Successful Response

application/json
delete
/notifications/{notification_id}
DELETE /notifications/{notification_id}?created_at=2025-11-28T01%3A30%3A23.559Z 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
OAuth2passwordRequired
Token URL:
Path parameters
notification_idstring · uuidRequired
Query parameters
created_atstring · date-timeRequired
Body
read_atstring · date-timeRequired
Responses
200

Successful Response

application/json
patch
/notifications/{notification_id}
PATCH /notifications/{notification_id}?created_at=2025-11-28T01%3A30%3A23.559Z HTTP/1.1
Host: api.stack-ai.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "read_at": "2025-11-28T01:30:23.559Z"
}
{
  "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
OAuth2passwordRequired
Token URL:
Responses
200

Successful Response

application/json
delete
/notifications/all/
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
OAuth2passwordRequired
Token URL:
Path parameters
notification_idstring · uuidRequired
Query parameters
role_namestringRequired
Responses
200

Successful Response

application/json
post
/notifications/{notification_id}/
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"
}
PreviousDocumentsNextTools

Last updated

Was this helpful?