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

# Create Assessment

> Generate an impact assessment report using Perplexity AI (ASYNC - returns job_id immediately).

This endpoint creates a background job for assessment generation. Use GET /jobs/{job_id}
to check status and retrieve results.

**Research Modes:**
- `fast`: Uses sonar-pro model (quick web search)
- `default`: Uses sonar-reasoning-pro model (balanced analysis)
- `deep`: Uses sonar-deep-research model (thorough research)

**Request Body:**
- `prompt`: Full prompt including scenario, portfolio/stock data, and analysis instructions
- `system_prompt`: Optional custom system prompt (defaults to Parallax AI analyst)
- `model`: Research mode - "fast", "default", or "deep"
- `max_tokens`: Max response tokens (default 8000)
- `temperature`: Model temperature (default 0.4)

**Response Format:**
```json
{
    "job_id": "assess-uuid-string",
    "status": "pending",
    "model": "default",
    "check_url": "/v1/jobs/{job_id}",
    "estimated_duration_seconds": 60
}
```

**Result Format (when complete):**
```json
{
    "success": true,
    "content": "# Impact Report\n...",
    "search_results": [...],
    "model_used": "sonar-reasoning-pro"
}
```

**Example Prompt:**
```
ANALYSIS TEMPLATE INSTRUCTIONS:
1. Executive Summary (risk/opportunity classification)
2. Direct Impact Analysis by sector
3. Strategic Recommendations

PORTFOLIO CONTEXT:
- Name: Tech Portfolio
- Holdings: AAPL (25%), MSFT (25%), GOOGL (20%)

SCENARIO: What if the Fed raises interest rates by 50 basis points?
```



## OpenAPI

````yaml POST /v1/assessment
openapi: 3.1.0
info:
  title: Parallax API
  description: >-
    Parallax by Chicago Global — AI-powered investment research and portfolio
    analytics. Multi-factor scoring, portfolio analysis and tracking, financial
    statements, analyst estimates, ETF analytics, valuation (DCF & multiples),
    macro and market telemetry, and AI-generated research reports.
  version: 1.1.0
servers:
  - url: https://api.chicago.global
security:
  - HTTPBearer: []
paths:
  /v1/assessment:
    post:
      tags:
        - v1
        - Assessment
      summary: Create Assessment
      description: >-
        Generate an impact assessment report using Perplexity AI (ASYNC -
        returns job_id immediately).


        This endpoint creates a background job for assessment generation. Use
        GET /jobs/{job_id}

        to check status and retrieve results.


        **Research Modes:**

        - `fast`: Uses sonar-pro model (quick web search)

        - `default`: Uses sonar-reasoning-pro model (balanced analysis)

        - `deep`: Uses sonar-deep-research model (thorough research)


        **Request Body:**

        - `prompt`: Full prompt including scenario, portfolio/stock data, and
        analysis instructions

        - `system_prompt`: Optional custom system prompt (defaults to Parallax
        AI analyst)

        - `model`: Research mode - "fast", "default", or "deep"

        - `max_tokens`: Max response tokens (default 8000)

        - `temperature`: Model temperature (default 0.4)


        **Response Format:**

        ```json

        {
            "job_id": "assess-uuid-string",
            "status": "pending",
            "model": "default",
            "check_url": "/v1/jobs/{job_id}",
            "estimated_duration_seconds": 60
        }

        ```


        **Result Format (when complete):**

        ```json

        {
            "success": true,
            "content": "# Impact Report\n...",
            "search_results": [...],
            "model_used": "sonar-reasoning-pro"
        }

        ```


        **Example Prompt:**

        ```

        ANALYSIS TEMPLATE INSTRUCTIONS:

        1. Executive Summary (risk/opportunity classification)

        2. Direct Impact Analysis by sector

        3. Strategic Recommendations


        PORTFOLIO CONTEXT:

        - Name: Tech Portfolio

        - Holdings: AAPL (25%), MSFT (25%), GOOGL (20%)


        SCENARIO: What if the Fed raises interest rates by 50 basis points?

        ```
      operationId: create_assessment_v1_assessment_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssessmentRequest'
        required: true
      responses:
        '202':
          description: Job created successfully
          content:
            application/json:
              schema: {}
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Job creation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    AssessmentRequest:
      properties:
        prompt:
          type: string
          title: Prompt
          description: >-
            Full prompt with scenario, portfolio/stock data, and template
            instructions
        system_prompt:
          anyOf:
            - type: string
            - type: 'null'
          title: System Prompt
          description: Custom system prompt (optional)
        model:
          type: string
          title: Model
          description: 'Research mode: ''fast'', ''default'', or ''deep'''
          default: default
        max_tokens:
          type: integer
          title: Max Tokens
          description: Max response tokens
          default: 8000
        temperature:
          type: number
          title: Temperature
          description: Model temperature (0.0-1.0)
          default: 0.4
      type: object
      required:
        - prompt
      title: AssessmentRequest
    ErrorResponse:
      properties:
        success:
          type: boolean
          title: Success
        error:
          type: string
          title: Error
        timestamp:
          type: string
          title: Timestamp
        details:
          anyOf:
            - type: string
            - type: 'null'
          title: Details
      type: object
      required:
        - success
        - error
        - timestamp
      title: ErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````