# Flowg8 · Personal notifications

Read notifications addressed to your signed-in user.

User token and active organization membership required. Only own entries are returned; administrator status grants no access to someone else’s inbox. Integration keys cannot use this endpoint. Supports cursor pagination (50 entries). Notification data includes id, runId, nodeId, title, message, flowName, referenceId, createdAt and emailStatus. It contains no attachment content or private URLs.

## GET /v1/notifications

Authentication: FLOWG8_ACCESS_TOKEN from Flowg8 sign-in
Required tenant header: X-Organization-Id.
Required user permissions: Active workspace membership required. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Request example (replace example IDs)

```sh
curl "https://api.flowg8.io/v1/notifications" \
  -H "authorization: Bearer $FLOWG8_ACCESS_TOKEN" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "items": [],
  "nextCursor": null
}
```

Source: /docs/notifications
Full schemas: /docs/openapi.json