> ## Documentation Index > Fetch the complete documentation index at: https://team.k0labs.com/llms.txt > Use this file to discover all available pages before exploring further. # Bulk operations > Execute bulk operations on notifications (mark_read, mark_unread, delete, archive) ## OpenAPI ````yaml api-docs/archived/notifications.json post /v1/regions/global/notifications/inbox/bulk openapi: 3.1.1 info: title: Notifications API version: 1.0.0 description: >- Notifications API for the k0rdent Enterprise platform. Provides in-app notifications, email, and notification settings management. All endpoints use path-based routing via the API Gateway with the pattern /v1/notifications/... contact: name: k0rdent Enterprise API Support email: api-support@example.com url: https://support.example.com license: name: Proprietary url: https://k0rdent.example.com/license servers: - url: '' description: For documentation only - url: https://api.example.com description: Arc API Base URL - url: https://api.internal.example.com description: Atlas API Base URL - url: http://localhost:{port} description: Local Development variables: port: default: '4020' description: Notifications service port security: - sessionAuth: [] tags: - name: Notifications description: Notification creation (system services) - name: Inbox description: User notification inbox operations - name: Settings description: Notification preference management paths: /v1/regions/global/notifications/inbox/bulk: post: tags: - Inbox summary: Bulk operations description: >- Execute bulk operations on notifications (mark_read, mark_unread, delete, archive) requestBody: required: true content: application/json: schema: type: object properties: action: type: string enum: - mark_read - mark_unread - delete - archive description: Action to perform ids: type: array items: type: string minItems: 1 maxItems: 1000 description: Notification IDs dryRun: type: boolean default: false description: Preview mode required: - action - ids responses: '207': description: Bulk operation results (Multi-Status) content: application/json: schema: type: object properties: success: type: boolean enum: - true data: type: object properties: action: type: string requested: type: number succeeded: type: number failed: type: number dryRun: type: boolean nullable: true wouldAffect: type: number nullable: true description: Dry-run only preview: type: array nullable: true description: Dry-run preview (max 20 items) items: $ref: '#/components/schemas/Notification' results: type: array items: type: object properties: id: type: string status: type: string enum: - success - failed error: type: object nullable: true meta: type: object '400': $ref: '#/components/responses/ValidationError' components: schemas: Notification: type: object description: Notification entity properties: id: type: string description: Notification identifier category: type: string enum: - system - cluster - server - billing - security - invitations description: Notification category priority: type: string enum: - low - normal - high - urgent description: Notification priority title: type: string description: Notification title message: type: string description: Notification message resourceType: type: string nullable: true description: Related resource type resourceId: type: string nullable: true description: Related resource identifier actionUrl: type: string nullable: true description: Primary action URL (simplified single URL for inbox list views) clickActionUrl: type: string nullable: true description: URL to navigate when notification is clicked primaryActionLabel: type: string nullable: true description: Primary action button label primaryActionUrl: type: string nullable: true description: Primary action button URL secondaryActionLabel: type: string nullable: true description: Secondary action button label secondaryActionUrl: type: string nullable: true description: Secondary action button URL read: type: boolean description: Read status readAt: type: string format: date-time nullable: true description: When notification was read createdAt: type: string format: date-time description: Creation timestamp required: - id - category - priority - title - message - read - createdAt ErrorResponse: type: object description: Standard error response following RFC 7807 properties: success: type: boolean enum: - false description: Success indicator error: type: object properties: code: type: string description: Error code examples: - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - RATE_LIMITED - INTERNAL_ERROR - SERVICE_UNAVAILABLE message: type: string description: Human-readable error message details: type: object nullable: true description: Additional error details required: - code - message meta: type: object description: Response metadata properties: requestId: type: string description: Unique request identifier timestamp: type: string format: date-time description: Response timestamp required: - success - error responses: ValidationError: description: Validation Error - The request body or parameters failed validation content: application/json: schema: allOf: - $ref: '#/components/schemas/ErrorResponse' examples: validationFailed: summary: Validation failed value: success: false error: code: VALIDATION_ERROR message: Invalid request body details: fields: name: Name is required slug: Slug must be lowercase alphanumeric meta: requestId: req_abc123 timestamp: '2024-01-15T10:30:00Z' securitySchemes: sessionAuth: type: apiKey in: cookie name: session description: Session-based authentication via HTTP-only cookie ````