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

# Save Hypotheses

> Persist a set of hypothesized bias correlations against a session.

Hypotheses survive session lifetime and are auto-promoted to
ShortcutClassGuidance records when the session is published with a
`carry_hypotheses=true` flag.



## OpenAPI

````yaml /api-reference/openapi.json post /api/playground/sessions/{session_id}/hypotheses
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: []
tags:
  - name: Authentication
  - name: Single sign-on
  - name: Social sign-in
  - name: SCIM provisioning
  - name: Projects
  - name: Datasets
  - name: Uploads and imports
  - name: Scans
  - name: Schedules
  - name: Healing
  - name: RAG corpora
  - name: Custom rules
  - name: Playground
  - name: Search and activity
  - name: Apps
  - name: Devices and agents
  - name: Discovery
  - name: DLP policy
  - name: DLP installation
  - name: Compliance
  - name: Audit trail
  - name: Reports
  - name: Export templates
  - name: Workspaces
  - name: Users
  - name: Invitations
  - name: API keys
  - name: Settings
  - name: Directory sync
  - name: Integrations
  - name: Pending actions
  - name: License
  - name: Onboarding
  - name: Support
  - name: Platform operations
  - name: Webhooks
paths:
  /api/playground/sessions/{session_id}/hypotheses:
    post:
      tags:
        - Playground
      summary: Save Hypotheses
      description: |-
        Persist a set of hypothesized bias correlations against a session.

        Hypotheses survive session lifetime and are auto-promoted to
        ShortcutClassGuidance records when the session is published with a
        `carry_hypotheses=true` flag.
      operationId: save_hypotheses_api_playground_sessions__session_id__hypotheses_post
      parameters:
        - name: session_id
          in: path
          required: true
          schema:
            type: string
            title: Session Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SaveHypothesesRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SaveHypothesesResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    SaveHypothesesRequest:
      properties:
        hypotheses:
          items:
            $ref: '#/components/schemas/HypothesisDraft'
          type: array
          maxItems: 100
          minItems: 1
          title: Hypotheses
      type: object
      required:
        - hypotheses
      title: SaveHypothesesRequest
    SaveHypothesesResponse:
      properties:
        session_id:
          type: string
          title: Session Id
        saved:
          type: integer
          title: Saved
        hypothesis_ids:
          items:
            type: string
          type: array
          title: Hypothesis Ids
      type: object
      required:
        - session_id
        - saved
        - hypothesis_ids
      title: SaveHypothesesResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    HypothesisDraft:
      properties:
        protected_column:
          type: string
          title: Protected Column
        target_column:
          type: string
          title: Target Column
        target_class:
          anyOf:
            - type: string
            - type: 'null'
          title: Target Class
        association:
          anyOf:
            - type: number
            - type: 'null'
          title: Association
        note:
          anyOf:
            - type: string
            - type: 'null'
          title: Note
      type: object
      required:
        - protected_column
        - target_column
      title: HypothesisDraft
    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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.