> ## 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.

# Create Platform User

> Create a new user as a platform owner, in any workspace.



## OpenAPI

````yaml /api-reference/openapi.json post /api/platform/users
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/platform/users:
    post:
      tags:
        - platform
      summary: Create Platform User
      description: Create a new user as a platform owner, in any workspace.
      operationId: create_platform_user_api_platform_users_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PlatformUserCreate'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserRead'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PlatformUserCreate:
      properties:
        email:
          type: string
          format: email
          title: Email
        password:
          type: string
          title: Password
        name:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Name
        roles:
          items:
            type: string
          type: array
          title: Roles
        is_active:
          type: boolean
          title: Is Active
          default: true
        workspace_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workspace Id
        is_platform_owner:
          type: boolean
          title: Is Platform Owner
          default: false
      type: object
      required:
        - email
        - password
      title: PlatformUserCreate
    UserRead:
      properties:
        id:
          type: integer
          title: Id
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        email:
          type: string
          title: Email
        is_active:
          type: boolean
          title: Is Active
        roles:
          items:
            type: string
          type: array
          title: Roles
          default: []
        mfa_enabled:
          type: boolean
          title: Mfa Enabled
          default: false
        is_platform_owner:
          type: boolean
          title: Is Platform Owner
          default: false
        workspace_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Workspace Id
        workspace:
          anyOf:
            - $ref: '#/components/schemas/WorkspaceSummary'
            - type: 'null'
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
      type: object
      required:
        - id
        - email
        - is_active
      title: UserRead
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    WorkspaceSummary:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        type:
          type: string
          title: Type
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
      type: object
      required:
        - id
        - name
        - slug
        - type
      title: WorkspaceSummary
      description: Compact workspace info embedded in auth payloads and user lists.
    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

````