> ## Documentation Index > Fetch the complete documentation index at: https://docs.opennous.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Record insights > Record what a call or email taught you about your own business. Workspace-level, with no account. Near-duplicates of existing insights are skipped. Records what a call or email taught you about your own business. Send every insight from one source in one call. Facts about the account itself belong in a [note](/public-api/notes). `category` is one of `product`, `positioning`, `market`, or `buyer`. Near-duplicates of existing insights are skipped, so `written` can be lower than `submitted`. ## OpenAPI ````yaml POST /v2/insights openapi: 3.1.0 info: title: OpenNous REST API version: 2.0.0 description: >- Read and write the OpenNous revenue context graph over HTTP. Authenticate with a workspace API key. servers: - url: https://api.opennous.cloud description: OpenNous Cloud security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: People - name: Accounts - name: Deals - name: Notes - name: Attention - name: Insights - name: Enrich & score - name: Organization - name: Workflows - name: Webhooks description: >- Subscribe to events and have them pushed to your own stack, with the account record attached. - name: Usage paths: /v2/insights: post: tags: - Insights summary: Record insights description: >- Record what a call or email taught you about your own business. Workspace-level, with no account. Near-duplicates of existing insights are skipped. operationId: recordInsights requestBody: required: true content: application/json: schema: type: object required: - insights properties: insights: type: array minItems: 1 items: type: object required: - category - content properties: category: type: string enum: - product - positioning - market - buyer description: Items with any other category are dropped. content: type: string minLength: 8 description: The insight in one sentence. quote: type: string description: The verbatim line that supports it. speaker: type: string description: Who said it. source_label: type: string description: Where these came from, for example `Acme discovery call`. occurred_at: type: string format: date-time example: insights: - category: product content: Call notes need to land in HubSpot for reps to use them. quote: If it doesn't land in HubSpot, my reps won't see it. speaker: Sarah Chen source_label: Acme discovery call occurred_at: '2026-09-24T15:00:00Z' responses: '201': description: How many were written. content: application/json: schema: type: object properties: written: type: integer description: >- Insights written. Lower than `submitted` when some were duplicates or had an unknown category. submitted: type: integer description: Insights that passed validation. example: written: 1 submitted: 1 '400': description: No insights, or none with content of 8 characters or more. content: application/json: schema: $ref: '#/components/schemas/Error' examples: insights_required: summary: insights_required value: error: insights_required no_valid_insights: summary: no_valid_insights value: error: no_valid_insights detail: each insight needs a category and content (≥8 chars) '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/UpgradeRequired' '403': $ref: '#/components/responses/ReadOnlyKey' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: schemas: Error: type: object description: >- Every error response. `error` is a stable machine code. Some errors add fields such as `detail`, `supported`, `max`, or `reason`. required: - error properties: error: type: string description: Machine-readable error code. detail: type: string description: Human-readable explanation, when there is one. additionalProperties: true responses: Unauthorized: description: Missing, unknown, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing: summary: api_key_required value: error: api_key_required invalid: summary: invalid_api_key value: error: invalid_api_key expired: summary: api_key_expired value: error: api_key_expired detail: >- This API key has expired. Create or rotate a key to get a fresh one. UpgradeRequired: description: The workspace is past its monthly operations limit and grace window. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: upgrade_required reason: ops_limit_reached current_plan: starter upgrade_url: /settings?section=billing ReadOnlyKey: description: A read-only key called a write endpoint. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: read_only_key detail: >- This API key is read-only — it can read context but cannot record, modify, connect, or send. Use a read/write key for write operations. RateLimited: description: More than 600 requests in a minute on this key. headers: RateLimit-Limit: schema: type: integer description: Requests allowed per window. RateLimit-Remaining: schema: type: integer description: Requests left in the window. RateLimit-Reset: schema: type: integer description: Seconds until the window resets. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: rate_limited InternalError: description: Unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: internal_error securitySchemes: bearerAuth: type: http scheme: bearer description: Workspace API key. Create one in **Settings → API keys**. apiKeyHeader: type: apiKey in: header name: X-API-Key description: The same key, sent as a header. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.