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

# Suggest exclusion phrases for a company

> Suggests phrases the user can add as exclusions to keep companies like the given one out of future results, based on the objective and why the company was included.



## OpenAPI

````yaml /api-reference/openapi.json post /exclusion-phrases
openapi: 3.0.0
info:
  title: Noonum API
  version: 1.0.0
  contact:
    name: Noonum Support
    email: hello@noonum.com
  description: >
    Create, read, update, and delete your own investment strategies, browse
    public premade strategies, run semantic search, and call supporting utility
    endpoints.
servers:
  - url: https://api.noonum.ai/v1
security:
  - bearerAuth: []
tags:
  - name: UserStrategies
    description: Create, read, update, and delete your own investment strategies.
  - name: PremadeStrategies
    description: Read public premade strategies and find the ones closest to an objective.
  - name: Helper
    description: >-
      Supporting endpoints for company lookup, objective editing, and health
      checks.
  - name: Benchmarks
    description: Read benchmark data.
  - name: Portfolios
    description: Create, read, update, and delete your portfolios.
  - name: Backtest
    description: Backtest a portfolio without saving it.
paths:
  /exclusion-phrases:
    post:
      tags:
        - Helper
      summary: Suggest exclusion phrases for a company
      description: >-
        Suggests phrases the user can add as exclusions to keep companies like
        the given one out of future results, based on the objective and why the
        company was included.
      operationId: app.api.v1.helper.exclusion_phrases
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - objective
                - companyId
                - inclusionReason
              properties:
                objective:
                  type: string
                  description: The strategy objective in natural language.
                companyId:
                  type: string
                  format: uuid
                  description: >-
                    ID of the company (organization) that appeared in the
                    results.
                inclusionReason:
                  type: string
                  description: Why the company was included in the results.
      responses:
        '200':
          description: Phrases the user can exclude, with a reason for each.
          content:
            application/json:
              schema:
                type: object
                required:
                  - phrases
                properties:
                  phrases:
                    type: array
                    minItems: 2
                    maxItems: 10
                    items:
                      type: object
                      required:
                        - phrase
                        - reason
                      additionalProperties: false
                      properties:
                        phrase:
                          type: string
                          description: A short phrase the user can add as an exclusion.
                        reason:
                          type: string
                          description: A brief reason for suggesting the phrase.
        '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:
                    type: string
                    description: A human-readable description of the error.
        '404':
          description: The company was not found.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    type: string
                    description: A human-readable description of the error.
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    type: string
                    description: A human-readable description of the error.
        '502':
          description: The upstream language model returned an error.
          content:
            application/json:
              schema:
                type: object
                description: A standard error response.
                properties:
                  error:
                    type: string
                    description: A human-readable description of the error.
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`

````