---
title: "Overview"
method: GET
path: "/api/orgs/{orgHandle}/projects/{projectHandle}/overview"
tags: ["Overview"]
---

# Overview

`GET /api/orgs/{orgHandle}/projects/{projectHandle}/overview`

## Request

- Base URL: `https://mcp.usertold.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.usertold.ai/api/orgs/{orgHandle}/projects/{projectHandle}/overview`
- Auth: none declared

Execute the UserTold overview operation.

## Path parameters

- `orgHandle` string, required: orgHandle path parameter
- `projectHandle` string, required: projectHandle path parameter

## Response `200`

Success

- object
  - `sessions` object, required
    - `total` number, required
    - `active` number, required
    - `completed` number, required
    - `completed_through_widget` number
    - `by_status` object, required
    - `failed_extraction` number, required
    - `with_evidence` number, required
    - `needs_attention` number, required
    - `by_review_state` object, required
  - `signals` object, required
    - `total` number, required
    - `by_type` object, required
  - `tasks` object, required
    - `total` number, required
    - `by_status` object, required
  - `studies` object
    - `total` number, required
  - `attention` object, required
    - `recent_sessions_with_evidence` number, required
    - `active_evidence` number, required
    - `unlinked_evidence` number, required
    - `tasks_awaiting_handoff` number, required
    - `tasks_in_linear` number, required
    - `recurrence_candidates` number, required
  - `intakes` object, required
    - `total` number, required
    - `active` number, required
    - `total_completed` number, required
    - `total_qualified` number, required
  - `recent_sessions` object[], required
    - `id` string, required
    - `project_ref` string, required
    - `study_ref` string, nullable, required
    - `intake_response_id` string, nullable, required
    - `participant_name` string, nullable, required
    - `participant_email` string, nullable, required
    - `participant_ref` string, nullable
    - `status` 'pending' | 'active' | 'completed' | 'abandoned' | 'error', required
    - `interview_mode` 'voice' | 'text' | 'async', required
    - `current_phase` string, nullable, required
    - `phase_started_at` string, nullable, required
    - `started_at` string, nullable, required
    - `completed_at` string, nullable, required
    - `duration_seconds` number, nullable, required
    - `transcript_key` string, nullable, required
    - `voice_vtt_key` string, nullable, required
    - `actions_vtt_key` string, nullable, required
    - `session_vtt_key` string, nullable, required
    - `snapshot_index_key` string, nullable, required
    - `timeline_key` string, nullable, required
    - `enriched_timeline_key` string, nullable, required
    - `audio_media_key` string, nullable, required
    - `screen_media_key` string, nullable, required
    - `signals_key` string, nullable, required
    - `summary` string, nullable, required
    - `analysis_summary` string, nullable, required
    - `signal_count` number, required
    - `talk_ratio` number, nullable, required
    - `quality_score` number, nullable, required
    - `consent_recording` number, required
    - `consent_analytics` number, required
    - `consent_followup` number, required
    - `cost_audio_cents` number, required
    - `cost_transcription_cents` number, required
    - `cost_analysis_cents` number, required
    - `deleted_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `interview_state` object
      - `capture_state` 'not_started' | 'in_progress' | 'completed' | 'ended_early' | 'interrupted' | 'connection_warning', required
      - `results_state` 'not_applicable' | 'pending' | 'processing' | 'ready' | 'failed', required
      - `review_state` 'in_progress' | 'processing' | 'ready_for_review' | 'completed_no_evidence' | 'needs_attention' | 'ended_early', required
      - `label` string, required
      - `tone` 'neutral' | 'info' | 'success' | 'warning' | 'danger', required
      - `primary_action` 'open' | 'wait' | 'review' | 'retry' | 'inspect', required
  - `top_tasks` object[], required
    - `id` string, required
    - `project_ref` string, required
    - `title` string, required
    - `description` string, nullable, required
    - `target_surface` 'product_under_test' | 'usertold_widget_interview' | 'interviewer_conductor_behavior' | 'ambiguous_needs_review', required
    - `status` 'backlog' | 'ready' | 'in_progress' | 'done' | 'wont_fix', required
    - `research_state` 'draft' | 'reviewed' | 'closed'
    - `priority_score` number, required
    - `priority_label` string, required
    - `effort_estimate` string, nullable, required
    - `signal_count` number, required
    - `session_count` number, required
    - `implementation_branch` string, nullable, required
    - `implementation_pr_url` string, nullable, required
    - `implementation_pr_number` number, nullable, required
    - `deployed_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
  - `setup` object, required
    - `has_api_keys` boolean, required
    - `can_start_interviews` boolean, required
    - `start_blocker` 'insufficient_credits' | 'openai_key_missing' | 'byok_key_unavailable' | 'billing_error' | 'null', nullable, required
    - `has_active_study` boolean, required
    - `has_active_intake` boolean, required
    - `has_linked_active_intake` boolean, required
    - `has_sessions` boolean, required
    - `widget_installation` object, nullable, required
      - `requested_url` string, uri, required
      - `final_url` string, uri, required
      - `verified_at` string, required
    - `paid_interview_completed` boolean, required

## Other responses

- `401`: Not authenticated
- `404`: Not found
- `422`: Domain error (non-retryable)
- `500`: Internal server error
- `503`: Domain error (retryable)

---

[API](https://skmtc.dev/usertold/apis/usertold-ai-api.md) · [All operations](https://skmtc.dev/usertold/apis/usertold-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usertold/apis/usertold-ai-api/revisions/37d5b4f88d38?raw)