> ## 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-v2.json post /exclusion-phrases
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:
  /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.v2.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:
                    description: A human-readable description of the error.
                    type: string
        '404':
          description: The company was not found.
          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`

````