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

# Enhance an investment objective

> Rewrites a natural-language investment objective into a clearer, more precise version and suggests a strategy name to go with it.



## OpenAPI

````yaml /api-reference/openapi-v2.json post /enhance-objective
openapi: 3.0.0
info:
  title: Noonum API v2
  version: 2.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create and manage investment strategies, portfolios, and backtests. The API
    covers the full strategy lifecycle, including creation and editing, the
    archive and revive flow, version submission and run state, result companies,
    evidence, factsheets, exposures, and taxonomy.
servers:
  - url: https://api.noonum.ai/v2
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and manage your own investment strategies.
  - name: Helper
    description: >-
      Shared utilities for company lookup and search, objective tooling, and a
      health check.
  - name: Portfolios
    description: Create, read, update, and delete portfolios.
  - name: Backtest
    description: Run a standalone backtest on a portfolio of companies.
paths:
  /enhance-objective:
    post:
      tags:
        - Helper
      summary: Enhance an investment objective
      description: >-
        Rewrites a natural-language investment objective into a clearer, more
        precise version and suggests a strategy name to go with it.
      operationId: app.api.v2.helper.enhance_objective
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - objective
              properties:
                objective:
                  description: The investment objective in natural language.
                  type: string
      responses:
        '200':
          description: >-
            The enhanced objective, a summary of the changes, and a suggested
            name.
          content:
            application/json:
              schema:
                type: object
                properties:
                  enhancedObjective:
                    type: string
                  improvementsSummary:
                    type: string
                  suggestedName:
                    type: string
                    description: >-
                      A short, memorable strategy name of 2 to 5 words for the
                      objective.
        '400':
          description: The request is invalid, for example a required field is missing.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: string
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: string
        '502':
          description: The upstream language model returned an error.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    description: A human-readable description of the error.
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: |
        Enter 'Bearer' followed by a space and then your JWT or API Key.
        Example: `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`
        or `Bearer YOUR_API_KEY_HERE`

````