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

# Create a new screening fact for your brand

> Creates a genuinely-new screening fact in your brand's own namespace, so answers can be reused across the flow without colliding with the shared facts or another brand's. Screening facts are never medical information; a multiple-choice fact must define its option codes.



## OpenAPI

````yaml /openapi/public-openapi.json post /v1/account/question-library/minted-facts
openapi: 3.1.0
info:
  title: Purple API
  version: 0.0.0
servers:
  - url: https://api.dev.purplelabelmd.com
security: []
tags:
  - description: Sign a patient in and out and manage the browser session.
    name: Sessions & authentication
  - description: Run the server-driven intake questionnaire question by question.
    name: Intake
  - description: Address autocomplete for the intake flow.
    name: Addresses
  - description: Read the public status of a patient's enrollment.
    name: Enrollment
  - description: Track a client's onboarding progress.
    name: Onboarding
  - description: Read back the platform configuration stored for your brand.
    name: Brand configuration
  - description: Enable offerings for your brand and set their display copy.
    name: Offering configuration
  - description: Start and track payments for an order.
    name: Payments
  - description: Subscribe to platform events and manage delivery endpoints.
    name: Webhooks
paths:
  /v1/account/question-library/minted-facts:
    post:
      tags:
        - Offering configuration
      summary: Create a new screening fact for your brand
      description: >-
        Creates a genuinely-new screening fact in your brand's own namespace, so
        answers can be reused across the flow without colliding with the shared
        facts or another brand's. Screening facts are never medical information;
        a multiple-choice fact must define its option codes.
      operationId: mintQualificationFact
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MintFactRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MintFactResult'
          description: the minted fact
        '400':
          $ref: '#/components/responses/OverlayBadRequest'
        '422':
          $ref: '#/components/responses/OverlayUnprocessable'
        '503':
          $ref: '#/components/responses/OverlayStoreUnavailable'
      security:
        - apiKey: []
components:
  schemas:
    MintFactRequest:
      description: >-
        mint a new brand-namespaced screening fact (phi_class 'none' is
        STRUCTURAL — not a field)
      properties:
        cardinality:
          enum:
            - single
            - multi
          type: string
        note:
          type: string
        options:
          description: required for a multiple-choice fact — the stable option codes
          items:
            properties:
              code:
                type: string
              exclusive:
                type: boolean
            required:
              - code
            type: object
          type: array
        slug:
          description: >-
            a human slug namespaced into the brand code space
            (`q_<brand>_<slug>`)
          type: string
        value_type:
          enum:
            - boolean
            - integer
            - decimal
            - string
            - date
            - coded
            - coded_set
            - measurement
          type: string
      required:
        - slug
        - value_type
        - cardinality
      type: object
    MintFactResult:
      properties:
        value:
          $ref: '#/components/schemas/MintedFact'
      required:
        - value
      type: object
    MintedFact:
      description: >-
        a minted screening fact — brand-namespaced code, phi_class 'none' by
        construction
      properties:
        cardinality:
          enum:
            - single
            - multi
          type: string
        code:
          type: string
        mode:
          enum:
            - collected
          type: string
        options:
          items:
            properties:
              code:
                type: string
              exclusive:
                type: boolean
            required:
              - code
            type: object
          type: array
        phi_class:
          enum:
            - none
          type: string
        value_type:
          type: string
      required:
        - code
        - value_type
        - cardinality
        - phi_class
        - mode
      type: object
    CompileProblem:
      description: RFC 7807 problem, extended with the structured compile issue list
      properties:
        issues:
          items:
            properties:
              code:
                type: string
              message:
                type: string
              where:
                type: string
            required:
              - code
              - where
              - message
            type: object
          type: array
        status:
          type: integer
        title:
          type: string
      required:
        - title
        - status
      type: object
  responses:
    OverlayBadRequest:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/CompileProblem'
      description: missing or invalid parameters
    OverlayUnprocessable:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/CompileProblem'
      description: validation failed — the declare-a-fact wall or the compile bar (422)
    OverlayStoreUnavailable:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/CompileProblem'
      description: >-
        the durable question store did not answer — nothing was written or
        changed; safe to retry once the store recovers
  securitySchemes:
    apiKey:
      description: 'Per-client API key (M2M). Presented as `Authorization: Bearer <key>`.'
      scheme: bearer
      type: http

````