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

# Bulk Invite

> Invite multiple users at once (max 50 per request).



## OpenAPI

````yaml /api-reference/openapi.json post /api/invitations/bulk
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
paths:
  /api/invitations/bulk:
    post:
      tags:
        - invitations
      summary: Bulk Invite
      description: Invite multiple users at once (max 50 per request).
      operationId: bulk_invite_api_invitations_bulk_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkInviteRequest'
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkInviteResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    BulkInviteRequest:
      properties:
        invitations:
          items:
            $ref: '#/components/schemas/BulkInviteEntry'
          type: array
          title: Invitations
        expires_hours:
          anyOf:
            - type: integer
            - type: 'null'
          title: Expires Hours
      type: object
      required:
        - invitations
      title: BulkInviteRequest
    BulkInviteResponse:
      properties:
        results:
          items:
            $ref: '#/components/schemas/BulkInviteResultEntry'
          type: array
          title: Results
        invited:
          type: integer
          title: Invited
          default: 0
        skipped:
          type: integer
          title: Skipped
          default: 0
        errors:
          type: integer
          title: Errors
          default: 0
      type: object
      required:
        - results
      title: BulkInviteResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    BulkInviteEntry:
      properties:
        email:
          type: string
          title: Email
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        roles:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Roles
      type: object
      required:
        - email
      title: BulkInviteEntry
    BulkInviteResultEntry:
      properties:
        email:
          type: string
          title: Email
        status:
          type: string
          title: Status
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
        invite_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Invite Id
      type: object
      required:
        - email
        - status
      title: BulkInviteResultEntry
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````