> ## Documentation Index > Fetch the complete documentation index at: https://docs.clarifeye.ai/llms.txt > Use this file to discover all available pages before exploring further. # Import an external interview transcript > Import the transcript of an interview recorded outside the platform (e.g. a Granola/Teams/Zoom export). **Admin only.** Creates a read-only interview (type "imported-interview") and enqueues an async parse that turns the raw text into speaker-labeled `chat_history` messages plus inferred metadata. The response returns immediately with `import_info.import_status = "parsing"`; poll the interview detail endpoint until it is "ready" (`status` becomes "completed") before reading the transcript. All metadata fields are optional — anything omitted is inferred from the transcript; importer-supplied values always win. To import several transcripts, call this endpoint once per transcript — each import becomes its own interview and parses independently. ## OpenAPI ````yaml /api-reference/openapi-public.yaml post /projects/{project_id}/interviews/import-transcript/ openapi: 3.0.3 info: title: Clarifeye Platform API — Public API description: > Forward-facing, supported REST API for new integrators of the Clarifeye Platform. Covers the curated public surface: authentication, knowledge management (documents), users & teams, signals, and tool execution. New integrations should target these endpoints. ## Authentication All endpoints require authentication. Include the Authorization header in every request using either format: - `Authorization: Token ` - `Authorization: Bearer ` version: 1.0.0 contact: name: Clarifeye Support servers: - url: https://eu.app.clarifeye.ai/api/v1 description: EU - url: https://us.app.clarifeye.ai/api/v1 description: US security: - BearerAuth: [] - TokenAuth: [] tags: - name: Users description: Manage users within a project - name: Invitations description: Manage project invitations - name: Documents description: Manage documents within a project - name: Signals description: Submit signals about the project's content for domain experts to review - name: Tools description: Execute configured AI tools with custom parameters - name: Interviews description: Assign and review structured interview conversations paths: /projects/{project_id}/interviews/import-transcript/: post: tags: - Interviews summary: Import an external interview transcript description: > Import the transcript of an interview recorded outside the platform (e.g. a Granola/Teams/Zoom export). **Admin only.** Creates a read-only interview (type "imported-interview") and enqueues an async parse that turns the raw text into speaker-labeled `chat_history` messages plus inferred metadata. The response returns immediately with `import_info.import_status = "parsing"`; poll the interview detail endpoint until it is "ready" (`status` becomes "completed") before reading the transcript. All metadata fields are optional — anything omitted is inferred from the transcript; importer-supplied values always win. To import several transcripts, call this endpoint once per transcript — each import becomes its own interview and parses independently. operationId: importInterviewTranscript parameters: - $ref: '#/components/parameters/ProjectId' requestBody: required: true content: application/json: schema: type: object required: - transcript properties: transcript: type: string description: >- The full raw transcript text, verbatim (200 to 1,500,000 characters). title: type: string description: Optional interview title. interview_date: type: string format: date description: Optional date the interview happened (YYYY-MM-DD). participants: type: array description: Optional participant names. items: type: string responses: '201': description: Interview created; parsing in progress content: application/json: schema: $ref: '#/components/schemas/Interview' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' components: parameters: ProjectId: name: project_id in: path required: true description: UUID of the project schema: type: string format: uuid schemas: Interview: type: object description: A structured interview conversation, including its full transcript. properties: id: type: string format: uuid readOnly: true name: type: string nullable: true description: Interview title (auto-generated from the topic when not provided). created_by: type: string format: uuid readOnly: true description: UUID of the user who created the interview. created_by_email: type: string format: email nullable: true readOnly: true description: >- Email of the user who created the interview (the importer, for imported interviews). type: type: string description: > Conversation type: "interview" (standard), "guided-interview" (multi-topic), or "imported-interview" (a read-only transcript of an interview recorded outside the platform, created via the import-transcript endpoint). type_additional_parameters: type: object description: Free-form parameters associated with the conversation type. chat_history: type: array description: Ordered list of transcript entries (messages, tool calls, etc.). items: type: object chat_memory: type: object description: Assistant memory state accumulated over the conversation. local_documents: type: array readOnly: true description: UUIDs of documents scoped locally to this interview. items: type: string format: uuid assigned_to: type: string format: uuid nullable: true readOnly: true description: >- UUID of the assigned user (null while a pending invite has not yet joined). assigned_by: type: string format: uuid nullable: true readOnly: true description: UUID of the user who created the assignment. assigned_to_email: type: string format: email nullable: true readOnly: true description: >- Assignee email, falling back to the invite email for not-yet-joined invitees. assigned_by_email: type: string format: email nullable: true readOnly: true is_pending_invite: type: boolean readOnly: true description: True when assigned to someone who has not yet joined the project. topics: type: array readOnly: true description: > Guided interviews only: the ordered topic agenda seeded at assign time, with per-topic progress. Empty for every other interview type. items: type: object properties: title: type: string description: type: string status: type: string enum: - open - resolved - dismissed description: | "open" while the topic still has to be covered; "resolved" or "dismissed" once it no longer is. The interview auto-completes when no topic is left open. skill_id: type: string nullable: true description: >- Standard-guide skill backing the topic; null for custom topics. campaign: allOf: - $ref: '#/components/schemas/InterviewCampaignRef' nullable: true readOnly: true description: Campaign this interview belongs to; null for ad hoc interviews. import_info: allOf: - $ref: '#/components/schemas/ImportedInterviewInfo' nullable: true readOnly: true status: type: string nullable: true readOnly: true enum: - pending - in_progress - completed description: Null for imported interviews until their transcript parse completes. write_scope: type: string enum: - local - global description: >- Whether edits stay local to the conversation or write to the shared knowledge store. created_at: type: string format: date-time readOnly: true updated_at: type: string format: date-time readOnly: true InterviewCampaignRef: type: object description: Nested campaign reference carried by interviews. properties: id: type: string format: uuid name: type: string ImportedInterviewInfo: type: object description: > Parse-pipeline state of an imported external transcript (interviews of type "imported-interview"). Null on every other interview type. The raw submitted transcript is never returned — the parsed `chat_history` is the transcript. properties: import_status: type: string enum: - parsing - ready - failed description: > "parsing" while the async parse runs (transcript not yet readable), "ready" once chat_history holds the speaker-labeled turns (status becomes "completed"), "failed" when parsing errored. participants: type: array description: >- Participant names (importer-supplied or inferred from the transcript). items: type: string interview_date: type: string format: date nullable: true description: Date the conversation happened (importer-supplied or inferred). error: type: string nullable: true description: Failure detail when import_status is "failed". Error: type: object properties: error: type: string description: Error message example: error: User not found ValidationError: type: object additionalProperties: type: array items: type: string example: email: - This field is required. responses: BadRequest: description: Bad request - invalid parameters or request body content: application/json: schema: oneOf: - $ref: '#/components/schemas/Error' - $ref: '#/components/schemas/ValidationError' Unauthorized: description: Unauthorized - missing or invalid authentication content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Authentication credentials were not provided. Forbidden: description: Forbidden - insufficient permissions content: application/json: schema: $ref: '#/components/schemas/Error' example: error: You do not have permission to perform this action. NotFound: description: Not found - resource does not exist content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Not found. securitySchemes: BearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer ' TokenAuth: type: apiKey in: header name: Authorization description: 'Use Authorization: Token ' ````