SaaSFlow
DevelopersAPIReferencenotifications

Batch delete

Delete several notifications in one call by passing their ids. Without cross-user rights a caller only deletes notifications addressed to themselves; ids outside that scope, or belonging to another company, are skipped instead of failing the batch, so a success response does not guarantee every id was removed. Deletion is permanent. To clear the unread badge while keeping the history, use `read-all`.

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.
POST
/companies/{companyId}/notifications/batch_delete

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/companies/string/notifications/batch_delete" \  -H "Content-Type: application/json" \  -d '{    "notificationIds": [      "string"    ]  }'
{  "success": true}

Create notification

Create a notification and return the created row. Most notifications are raised by SaaSFlow itself; use this when your own workflow needs to put something in a user's bell menu. `recipientUserId` is required, and addressing anyone other than the calling user needs cross-user rights, otherwise the request is refused with 403.

Read

Mark one notification as read and return the updated row. Returns 404 if the notification does not exist or belongs to another company.