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

# Get Resolution Rate

> Returns actual end-to-end resolution for real conversation threads, with aggregate and daily atomic breakdowns.

The denominator is the number of distinct real conversation threads with a completed, inbound-triggered, non-proactive actual-autopilot decision in the inclusive date range.

A thread enters the resolution numerator when its final qualifying decision is resolved and its final response was sent.

`fully_autonomous` uses the same denominator and counts the stricter subset where no known teammate sent an outbound message and no escalation or answer-and-escalate occurred during the selected date range.

Both rates are decimals from 0 to 1. Aggregate counts are sums of the dense daily series. Each non-zero breakdown row contains `final_disposition`, `final_response_sent`, `human_intervention`, `escalated_at_any_point`, and `count`.


## OpenAPI

````yaml GET /v1/insights/resolution_rate
openapi: 3.0.0
info:
  title: Conduit API
  version: 1.0.0
  description: Public API for Conduit.
servers:
  - url: https://api.conduit.ai
    description: Production
security: []
tags:
  - name: meta
    description: Discovery and API metadata endpoints.
  - name: agents
    description: >-
      V2 chat agent configuration, including instructions, skills, triggers, and
      automation behavior.
  - name: contacts
    description: >-
      Contact profile and contact-scoped related resources such as tickets and
      calls.
  - name: workspaces
    description: Workspaces accessible to the current API token.
  - name: escalations
    description: >-
      Chat escalations that require operator review, including message, proposed
      response, and disposition context when available.
  - name: conversations
    description: >-
      Canonical message threads. Use these endpoints to list threads, inspect
      conversation state, read transcripts, and send replies.
  - name: conversation-tags
    description: >-
      Conversation labels, root topics, and subtopics used for classification
      and topic analytics.
  - name: tickets
    description: >-
      Operational queue items tied to conversations, including ticket-scoped
      transcripts and replies.
  - name: calls
    description: Phone call records, transcripts, summaries, and recordings when available.
  - name: reservations
    description: >-
      PMS reservations synced from the workspace's integrations (Hostaway,
      Guesty, Airbnb, etc.), including guest identity, payment status, and stay
      dates.
  - name: appointments
    description: >-
      Scheduled appointments (bookings) backed by the Conduit booking service.
      Exposes allocation context and the upstream booking-service `external_id`.
  - name: helpdesk_tickets
    description: >-
      Helpdesk tickets mirrored from external helpdesk integrations (Zendesk,
      Pylon, Plain), including requester identity and upstream metadata.
  - name: kb
    description: >-
      Knowledge base search and node management. Nodes represent knowledge base
      entries (files or directories), chunks are the indexed retrieval units
      used by search.
  - name: skills
    description: >-
      Workspace agent skills that can be attached to V2 chat agents.
      Sidebar/global-assistant skills are intentionally excluded.
  - name: custom_tools
    description: >-
      Custom code tools: user-authored Python/JavaScript functions executed in a
      sandbox when an agent calls them. Includes a runtimes endpoint describing
      the entrypoint signature, return shape, and available dependencies per
      language.
  - name: inbox_types
    description: >-
      Workspace inbox types. Each id is stable and usable as a message trigger's
      `inboxTypeId` and as the `inbox_type_id` filter on list conversations.
  - name: workflows
    description: >-
      Workspace automation workflows: definitions, executions, and per-execution
      event timelines.
  - name: insights
    description: Aggregated workspace analytics, such as conversation automation rate.
paths:
  /v1/insights/resolution_rate:
    get:
      tags:
        - insights
      summary: Get resolution rate
      description: >-
        Returns the share of eligible conversation threads whose final agent
        decision was resolved and sent. The additive fully_autonomous metric is
        the stricter subset with no teammate outbound and no escalation during
        the selected date range.
      operationId: getResolutionRate
      parameters:
        - schema:
            type: string
            description: Workspace to query.
            example: j57demo8f8x7c9v0n2q4r6t8y1u3i5o
          required: true
          name: workspace_id
          in: query
        - schema:
            type: string
            description: Inclusive range start (ISO 8601 date).
            example: '2026-06-01'
          required: true
          name: start_date
          in: query
        - schema:
            type: string
            description: Inclusive range end (ISO 8601 date). Max 90 days from start.
            example: '2026-06-30'
          required: true
          name: end_date
          in: query
        - schema:
            type: string
            description: >-
              Optional inbox type / contact category to segment by. Omit for the
              whole workspace.
            example: guest
          required: false
          name: category_name
          in: query
      responses:
        '200':
          description: Resolution rate with fully autonomous subset
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      numerator:
                        type: number
                      denominator:
                        type: number
                      rate:
                        type: number
                      range:
                        type: object
                        properties:
                          start_date:
                            type: string
                          end_date:
                            type: string
                        required:
                          - start_date
                          - end_date
                      formula_version:
                        type: string
                      fully_autonomous:
                        type: object
                        properties:
                          numerator:
                            type: number
                          denominator:
                            type: number
                          rate:
                            type: number
                        required:
                          - numerator
                          - denominator
                          - rate
                      breakdown:
                        type: array
                        items:
                          type: object
                          properties:
                            final_disposition:
                              type: string
                              enum:
                                - resolved
                                - unresolved
                                - escalation_and_answer
                                - escalated
                                - unknown
                            final_response_sent:
                              type: boolean
                            human_intervention:
                              type: boolean
                            escalated_at_any_point:
                              type: boolean
                            count:
                              type: integer
                              minimum: 0
                          required:
                            - final_disposition
                            - final_response_sent
                            - human_intervention
                            - escalated_at_any_point
                            - count
                      series:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            numerator:
                              type: number
                            denominator:
                              type: number
                            rate:
                              type: number
                            fully_autonomous:
                              type: object
                              properties:
                                numerator:
                                  type: number
                                denominator:
                                  type: number
                                rate:
                                  type: number
                              required:
                                - numerator
                                - denominator
                                - rate
                            breakdown:
                              type: array
                              items:
                                type: object
                                properties:
                                  final_disposition:
                                    type: string
                                    enum:
                                      - resolved
                                      - unresolved
                                      - escalation_and_answer
                                      - escalated
                                      - unknown
                                  final_response_sent:
                                    type: boolean
                                  human_intervention:
                                    type: boolean
                                  escalated_at_any_point:
                                    type: boolean
                                  count:
                                    type: integer
                                    minimum: 0
                                required:
                                  - final_disposition
                                  - final_response_sent
                                  - human_intervention
                                  - escalated_at_any_point
                                  - count
                          required:
                            - date
                            - numerator
                            - denominator
                            - rate
                            - fully_autonomous
                            - breakdown
                    required:
                      - numerator
                      - denominator
                      - rate
                      - range
                      - formula_version
                      - fully_autonomous
                      - breakdown
                      - series
                required:
                  - data
                description: >-
                  Resolution rate for eligible conversation threads, with fully
                  autonomous completion as a stricter additive subset.
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                description: Standard error response.
                example:
                  error: Invalid workspace id
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                description: Standard error response.
                example:
                  error: Invalid workspace id
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                description: Standard error response.
                example:
                  error: Invalid workspace id
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                description: Standard error response.
                example:
                  error: Invalid workspace id
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Token
      description: >-
        Conduit API token. Use `Authorization: Bearer <token>`. Read/write
        endpoints require a token with write access.

````