> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cynopsis.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Whitelist record

> Create a new whitelist record with rules, bucket, and subject.



## OpenAPI

````yaml post /api/whitelist
openapi: 3.0.3
info:
  title: Athena API
  version: v3
  x-logo:
    url: https://cynopsis.co/wp-content/uploads/2021/03/logo-2.png
    altText: Cynopsis Solutions
  description: >-
    ATHENA is an advanced real-time transaction monitoring solution designed to
    detect and prevent money laundering, fraud, and terrorism financing. Powered
    by proprietary AML rules, ATHENA analyzes transactions in real time,
    providing clear, intuitive visual insights to streamline compliance
    processes.
        
        ✅ Real-Time Monitoring – Instantly analyzes transaction data to detect anomalies and potential compliance risks.
        ✅ Visualized Insights – Converts complex data into easy-to-understand charts, aiding faster decision-making.
        ✅ Seamless Integration – Easily integrates with existing financial and compliance systems.
        
        Ideal for financial institutions, fintech companies, and regulated businesses, ATHENA enhances risk management and ensures regulatory compliance with ease.
  contact:
    email: tech@cynopsis.co
servers:
  - url: http://localhost/api
    description: Local development server
security: []
paths:
  /api/whitelist:
    post:
      tags:
        - Whitelist
      summary: Create a Whitelist record
      description: Create a new whitelist record with rules, bucket, and subject.
      operationId: whitelist_create
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                rules:
                  type: array
                  items:
                    type: integer
                  description: List of rule IDs
                bucket:
                  type: string
                  description: Bucket identifier
                subject:
                  type: string
                  description: Subject identifier
              required:
                - rules
                - bucket
                - subject
              description: Whitelist creation request payload
      responses:
        '201':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Whitelist record ID
                  rules:
                    type: array
                    items:
                      type: integer
                    description: List of rule IDs
                  bucket:
                    type: string
                    description: Bucket identifier
                  subject:
                    type: string
                    description: Subject identifier
                  created_at:
                    type: string
                    format: date-time
                    description: Creation timestamp
                  updated_at:
                    type: string
                    format: date-time
                    description: Last update timestamp
                  created_by:
                    type: integer
                    description: ID of user who created the record
                  modified_by:
                    type: integer
                    description: ID of user who last modified the record
                required:
                  - id
                description: Whitelist object with all details
          description: Whitelist record created successfully
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    description: Error message
                  code:
                    type: string
                    description: Error code (optional)
                  field_errors:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
                    description: Field-specific validation errors (optional)
                required:
                  - detail
                description: Standard error response
          description: Invalid request data or subject already in blacklist
      security:
        - CustomAuthentication: []
        - cookieAuth: []
        - BearerAuth: []
components:
  securitySchemes:
    CustomAuthentication:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT token obtained from AWS Cognito or custom authentication service
    cookieAuth:
      type: apiKey
      in: cookie
      name: sessionid

````