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

> ## Agent Instructions
> Reconify's API reference is read-only for customer data. Do not invent endpoints or authentication behavior beyond the OpenAPI contract.
> The public OpenAPI document contains only the external /v1 contract. Dashboard business routes are intentionally excluded.

# Add an issue note

> Adds an append-only investigation note to an issue. Repeat a request with the same Idempotency-Key to replay the original note.



## OpenAPI

````yaml /openapi/reconify.openapi.json post /v1/issues/{issue_id}/notes
openapi: 3.1.0
info:
  description: Public event ingestion and issue operations for Reconify.
  title: Reconify API
  version: 1.0.0
servers:
  - description: Reconify API root
    url: https://api.reconifyhq.com
security: []
tags:
  - description: Submit events through the public v1 ingestion API.
    name: Event Ingestion API
  - description: Public API metadata and health checks.
    name: API Metadata
  - description: Read received events and evidence linked to issues.
    name: Event Reads
  - description: Discover and coordinate evidence-backed monitoring issues.
    name: Issue Operations
  - description: Read organization details and assignable member IDs.
    name: Organization
paths:
  /v1/issues/{issue_id}/notes:
    post:
      tags:
        - Issue Operations
      summary: Add an issue note
      description: >-
        Adds an append-only investigation note to an issue. Repeat a request
        with the same Idempotency-Key to replay the original note.
      operationId: add-issue-note
      parameters:
        - description: Issue identifier.
          in: path
          name: issue_id
          required: true
          schema:
            type: string
        - description: >-
            Optional key for safe retries. The same key must represent the same
            issue and note body.
          in: header
          name: Idempotency-Key
          required: false
          schema:
            maxLength: 255
            minLength: 1
            type: string
      requestBody:
        content:
          application/json:
            example:
              body: Confirmed that the provider callback arrived late.
            schema:
              $ref: '#/components/schemas/AddNoteRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              example:
                body: Confirmed that the provider callback arrived late.
                created_at: '2026-01-01T12:00:00Z'
                id: 00000000-0000-7000-8000-000000000003
              schema:
                $ref: '#/components/schemas/Note'
          description: Created
        '400':
          content:
            application/json:
              example:
                code: invalid_input
                message: request is invalid
              schema:
                $ref: '#/components/schemas/Error'
          description: Bad Request
        '401':
          content:
            application/json:
              example:
                code: unauthorized
                message: authentication required
              schema:
                $ref: '#/components/schemas/Error'
          description: Unauthorized
        '403':
          content:
            application/json:
              example:
                code: forbidden
                message: credential cannot access this organization
              schema:
                $ref: '#/components/schemas/Error'
          description: Forbidden
        '404':
          content:
            application/json:
              example:
                code: not_found
                message: resource not found
              schema:
                $ref: '#/components/schemas/Error'
          description: Not Found
        '409':
          content:
            application/json:
              example:
                code: idempotency_conflict
                message: Idempotency-Key was already used for a different request
              schema:
                $ref: '#/components/schemas/Error'
          description: Conflict
        '503':
          content:
            application/json:
              example:
                code: database_unavailable
                message: public API data is unavailable
              schema:
                $ref: '#/components/schemas/Error'
          description: Service Unavailable
      security:
        - organizationApiKey: []
components:
  schemas:
    AddNoteRequest:
      additionalProperties: false
      properties:
        body:
          description: Append-only investigation note.
          maxLength: 10000
          minLength: 1
          type: string
      required:
        - body
      type: object
    Note:
      properties:
        author_user_id:
          description: User who created the note, when available.
          type:
            - string
            - 'null'
        body:
          description: Append-only investigation note.
          type: string
        created_at:
          description: When the note was created.
          format: date-time
          type: string
        id:
          description: Stable note identifier.
          type: string
      required:
        - id
        - body
        - created_at
      type: object
    Error:
      properties:
        code:
          description: Stable machine-readable error code.
          type: string
        detail:
          description: Human-readable details about the request failure.
          type: string
        message:
          description: Short human-readable explanation.
          type: string
        status:
          description: HTTP status code for the problem.
          type: integer
        title:
          description: General category of the problem.
          type: string
      type: object
  securitySchemes:
    organizationApiKey:
      description: Organization API key. Use a write-scoped key for event ingestion.
      scheme: bearer
      type: http

````