> ## 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.

# Assign an issue

> Assigns an issue to an organization member or unassigns it with null.



## OpenAPI

````yaml /openapi/reconify.openapi.json patch /v1/issues/{issue_id}
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}:
    patch:
      tags:
        - Issue Operations
      summary: Assign an issue
      description: Assigns an issue to an organization member or unassigns it with null.
      operationId: update-issue
      parameters:
        - description: Issue identifier.
          in: path
          name: issue_id
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            example:
              assigned_to: 00000000-0000-7000-8000-000000000002
            schema:
              $ref: '#/components/schemas/PatchIssueRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                category: missing_event
                id: 00000000-0000-7000-8000-000000000001
                message: Payment flow is missing wallet credit evidence
                opened_at: '2026-01-01T00:00:00Z'
                severity: medium
                status: open
              schema:
                $ref: '#/components/schemas/Issue'
          description: OK
        '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
        '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:
    PatchIssueRequest:
      additionalProperties: false
      description: >-
        Assignment update. Status transitions are not accepted by this version
        of the public API.
      properties:
        assigned_to:
          description: Organization member ID to assign, or null to unassign.
          type:
            - string
            - 'null'
      required:
        - assigned_to
      type: object
    Issue:
      properties:
        assigned_to:
          description: User ID of the assigned organization member.
          type:
            - string
            - 'null'
        category:
          description: Deterministic reason the finding was raised.
          enum:
            - business_failure
            - missing_event
            - mismatch
            - duplicate_or_conflict
          type: string
        id:
          description: Stable issue identifier.
          type: string
        message:
          description: Evidence-backed explanation of the issue.
          type: string
        opened_at:
          description: When the issue was opened.
          format: date-time
          type: string
        operation_id:
          description: Related monitored operation identifier.
          type:
            - string
            - 'null'
        resolved_at:
          description: When the issue was resolved, if applicable.
          format: date-time
          type:
            - string
            - 'null'
        severity:
          description: Public severity classification.
          enum:
            - high
            - medium
          type: string
        status:
          description: Current monitoring finding state.
          enum:
            - open
            - resolved
            - resolved_late
          type: string
      required:
        - id
        - status
        - category
        - severity
        - message
        - opened_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

````