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

# Add a transcript as text

> Adds the meeting’s transcript from pasted text, up to 500,000 characters: "Name: what they said" lines, with or without times. It replaces any transcript the meeting has. Give speakers to say who’s who, and draft to start drafting the File note at once.



## OpenAPI

````yaml /openapi/advisor.json post /meetings/{meeting}/transcript
openapi: 3.1.0
info:
  title: Redbark Advisor API
  version: 2.0.0
  description: >-
    Read and write access to one advice firm in Redbark Advisor: clients,
    checklists, documents, money, messages, reports, team and webhooks. Send an
    API key or a connected app’s access token as a bearer token. A credential
    carries scopes, one read and one write per area, and each call says the
    scope it needs. A write scope brings its read scope. Each key may make 120
    requests a minute.
servers:
  - url: https://advisor.redbark.com/api/v1
security:
  - bearerAuth: []
tags:
  - name: Firm
    description: The firm, its name and its branding.
  - name: Team
    description: Team members and their roles.
  - name: Clients
    description: Clients, their people and portal invites.
  - name: Checklists
    description: Checklist templates, the checklists sent to clients and their answers.
  - name: Documents
    description: Documents clients upload and the details read from them.
  - name: Money
    description: Bank connections, accounts, balances and transactions.
  - name: Document types
    description: Document types, their fields and the client facts they fill.
  - name: Messages
    description: Messages between the firm and clients.
  - name: Reports
    description: Reports exported for clients.
  - name: Meetings
    description: Client meetings, their agendas, transcripts, File notes and actions.
  - name: Webhooks
    description: Webhook endpoints and their deliveries.
  - name: Webhook events
    description: Events sent to your webhook endpoints.
paths:
  /meetings/{meeting}/transcript:
    post:
      tags:
        - Meetings
      summary: Add a transcript as text
      description: >-
        Adds the meeting’s transcript from pasted text, up to 500,000
        characters: "Name: what they said" lines, with or without times. It
        replaces any transcript the meeting has. Give speakers to say who’s who,
        and draft to start drafting the File note at once.
      operationId: add_transcript_text
      parameters:
        - name: meeting
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 60
            description: The meeting id, from list_meetings.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                text:
                  type: string
                  maxLength: 600000
                speakers:
                  anyOf:
                    - type: array
                      items:
                        type: object
                        properties:
                          label:
                            type: string
                            maxLength: 200
                          attendee_id:
                            anyOf:
                              - type: string
                                maxLength: 60
                              - type: 'null'
                            description: >-
                              The attendee who spoke, from get_meeting, or null
                              for nobody at the meeting.
                        required:
                          - label
                          - attendee_id
                        additionalProperties: true
                      maxItems: 50
                      description: 'Who’s who: each speaker label and the attendee it is.'
                    - type: 'null'
                draft:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                  description: >-
                    Start drafting the File note. Each draft counts as one Ask
                    question.
              required:
                - text
      responses:
        '201':
          description: Created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingTranscript'
        '400':
          description: The request is not valid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The API key or access token is missing, wrong, expired or revoked.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: >-
            subscription_required: the firm has no active subscription, so it
            cannot add or invite clients or send checklists.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: >-
            The credential lacks the scope this call needs, the call is for
            admins only, or the member it acts as has left the firm.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No such resource in this firm.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            The resource is in a state that does not allow this, such as an
            archived client.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: The request body is too large.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests. See the Retry-After header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Something went wrong on our side. Try again.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth:
            - meetings:write
components:
  schemas:
    MeetingTranscript:
      type: object
      properties:
        object:
          type: string
          enum:
            - meeting_transcript
        id:
          type: string
        meeting_id:
          type: string
        origin:
          type: string
          enum:
            - upload
            - paste
        format:
          type: string
          enum:
            - vtt
            - docx
            - txt
        original_name:
          anyOf:
            - type: string
            - type: 'null'
        size_bytes:
          anyOf:
            - type: number
            - type: 'null'
        duration_seconds:
          anyOf:
            - type: number
            - type: 'null'
        line_count:
          type: number
        speakers:
          type: array
          items:
            type: object
            properties:
              label:
                type: string
                description: The speaker as the transcript names them.
              attendee_id:
                anyOf:
                  - type: string
                  - type: 'null'
              name:
                anyOf:
                  - type: string
                  - type: 'null'
              best_guess:
                type: boolean
                description: >-
                  Matched loosely, such as a label like "Priya’s iPhone". Check
                  it.
            required:
              - label
              - attendee_id
              - name
              - best_guess
            additionalProperties: true
        added_by_name:
          anyOf:
            - type: string
            - type: 'null'
        created_at:
          type: string
          description: An ISO 8601 time in UTC.
      required:
        - object
        - id
        - meeting_id
        - origin
        - format
        - original_name
        - size_bytes
        - duration_seconds
        - line_count
        - speakers
        - added_by_name
        - created_at
      additionalProperties: true
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - invalid_request_error
                - authentication_error
                - permission_error
                - rate_limit_error
                - api_error
            code:
              type: string
            message:
              type: string
            param:
              anyOf:
                - type: string
                - type: 'null'
            request_id:
              type: string
          required:
            - type
            - code
            - message
            - param
            - request_id
          additionalProperties: true
      required:
        - error
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        A firm API key, shown once when it is made, or a connected app’s OAuth
        access token. Each operation lists the scope it needs, such as
        clients:write.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.