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

# Dismiss recommendation

> Dismiss a content intelligence recommendation

Marks a recommendation as dismissed, removing it from the active list. This is useful for recommendations your team has reviewed and decided not to act on.

**Scope required:** `content_intelligence:read`

## Path parameters

<ParamField path="id" type="string" required>UUID of the content intelligence recommendation.</ParamField>

## Request body

<ParamField body="status" type="string" required>Must be `"dismissed"`.</ParamField>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": {
      "id": "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
      "status": "dismissed",
      "updated_at": "2026-03-02T10:30:00.000Z"
    }
  }
  ```
</ResponseExample>

<Note>
  Dismissed recommendations are not permanently deleted. They remain in the database and can be filtered by status. The nightly pipeline may generate new recommendations for the same gap in future runs.
</Note>


## OpenAPI

````yaml PATCH /content-intelligence/{id}
openapi: 3.1.0
info:
  title: Hrizn Public API
  version: 1.2.0
  description: >
    The Hrizn Public API allows partners to programmatically create content,
    manage inventory descriptions, and integrate with the Hrizn platform.


    All endpoints are prefixed with `/public` and require an API key passed via
    the `X-API-Key` header (except the health check).
  contact:
    email: support@hrizn.io
servers:
  - url: https://api.app.hrizn.io/v1/public
    description: Production
security:
  - apiKeyAuth: []
tags:
  - name: IdeaClouds
    description: Create and manage AI-powered keyword research
  - name: Content Intelligence
    description: AI-powered content gap analysis and recommendations
  - name: Content
    description: Generate content from IdeaClouds
  - name: Compliance
    description: Run OEM compliance checks on content
  - name: Content Tools
    description: Generate SEO metadata, schemas, and social snippets
  - name: Inventory
    description: Access vehicle data and AI descriptions
  - name: Site
    description: View dealership details and configuration
  - name: Webhooks
    description: Manage webhook subscriptions for real-time events
  - name: Reference
    description: Look up available types, scopes, and events
  - name: Social
    description: >-
      Zernio-backed social posting and reviews across all connected platforms
      (X, Facebook, Instagram, LinkedIn, Google Business Profile)
  - name: Health
    description: Health check (no authentication)
paths:
  /content-intelligence/{id}:
    patch:
      tags:
        - Content Intelligence
      summary: Dismiss recommendation
      description: Marks a recommendation as dismissed, removing it from the active list.
      operationId: dismissContentIntelligence
      parameters:
        - $ref: '#/components/parameters/ContentIntelligenceId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DismissContentIntelligenceInput'
      responses:
        '200':
          description: Recommendation dismissed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContentIntelligenceDismissedResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    ContentIntelligenceId:
      name: id
      in: path
      required: true
      schema:
        type: string
        format: uuid
      description: Content intelligence recommendation ID
  schemas:
    DismissContentIntelligenceInput:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          enum:
            - dismissed
          description: Must be `dismissed`.
    ContentIntelligenceDismissedResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            id:
              type: string
              format: uuid
            status:
              type: string
              example: dismissed
            updated_at:
              type: string
              format: date-time
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: validation_error
            message:
              type: string
              example: 'keyword: Required'
            details:
              type: object
            request_id:
              type: string
  responses:
    BadRequest:
      description: Validation error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Forbidden:
      description: API key lacks required scope
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    RateLimited:
      description: Rate limit exceeded
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Hrizn API key (prefix hzk_)

````