> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # Edit content or dismiss/restore an insight > Update the fact text (sets `is_user_edited=true`) and/or set its status to `dismissed` (hides from search context and the UI) or `active`. ## OpenAPI ````yaml /api-reference/openapi-v1.json patch /v1/company-insights/{id} openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/company-insights/{id}: patch: tags: - Company Insights summary: Edit content or dismiss/restore an insight description: >- Update the fact text (sets `is_user_edited=true`) and/or set its status to `dismissed` (hides from search context and the UI) or `active`. operationId: updateCompanyInsight parameters: - in: path name: id required: true schema: type: string description: Insight UUID requestBody: content: application/json: schema: type: object properties: content: type: string minLength: 1 maxLength: 200 description: New compact fact text. Sets is_user_edited=true. status: type: string enum: - active - dismissed description: Set to "dismissed" to hide, "active" to restore. responses: '200': description: Insight updated content: application/json: schema: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/CompanyInsight' required: - success - data example: success: true data: id: 11111111-1111-1111-1111-111111111111 organization_company_id: 22222222-2222-2222-2222-222222222222 content: 'May 2026 rev: $100M ARR' category: financials topic: revenue observation_date: '2026-05-15' status: active is_user_edited: false source_activity_id: 33333333-3333-3333-3333-333333333333 source_person_id: 44444444-4444-4444-4444-444444444444 created_at: '2026-05-15T14:32:11.000Z' updated_at: '2026-05-15T14:32:11.000Z' '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: CompanyInsight: type: object properties: id: type: string format: uuid description: Insight UUID. organization_company_id: type: string format: uuid description: Company this insight is attached to. content: type: string description: 'Compact fact (under ~12 words), e.g. "May 2026 rev: $100M ARR".' category: type: string enum: - financials - funding_ma - team - customers - product - tech - gtm - competitive - culture - other description: Subject-based category of the fact. topic: type: string description: >- Short slug for the topic the fact is about (e.g. revenue, headcount, cto). observation_date: type: string description: ISO date (YYYY-MM-DD) when the fact was observed. status: type: string enum: - active - dismissed description: Whether the insight is active or dismissed. is_user_edited: type: boolean description: True if a teammate has edited this insight after creation. source_activity_id: type: - string - 'null' format: uuid description: Activity that produced this insight. source_person_id: type: - string - 'null' format: uuid description: Person whose note/transcript was the source. created_at: type: string description: ISO 8601 creation timestamp. updated_at: type: string description: ISO 8601 last-update timestamp. required: - id - organization_company_id - content - category - topic - observation_date - status - is_user_edited - source_activity_id - source_person_id - created_at - updated_at securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ````