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

# Create meeting recording share link

> Makes a recording public by creating a share link. Anyone with the returned `url` can watch the recording without signing in. Choose which sections the page shows with `show_summary`, `show_transcript` and `show_attendees` (all true by default). The summary defaults to the recording's current AI summary; pass `summary_markdown` to share an edited version. A recording can have several links, each with its own settings. Delete a link to stop sharing through it. API keys need the `meetings:write` scope to create or update links and `meetings:delete` to delete them. Session and OAuth callers can share recordings they can see.



## OpenAPI

````yaml /api-reference/openapi-v1.json post /v1/meeting-recordings/{id}/share-links
openapi: 3.1.0
info:
  title: Stardex API (v1)
  version: 1.0.0
  description: >-
    Stardex ATS API — manage candidates, jobs, companies, and recruiting
    workflows.
servers:
  - url: https://api.stardex.ai
    description: Production API server
security:
  - bearerAuth: []
tags:
  - name: Persons
    description: Manage person records — contacts, work history, and custom fields.
  - name: Jobs
    description: Manage job postings — pipeline stages, team members, and custom fields.
  - name: Candidates
    description: Manage candidate records and pipeline stage transitions.
  - name: Companies
    description: Browse and retrieve company records.
  - name: Lists
    description: Create, search, and retrieve saved person and company lists.
  - name: Person Activities
    description: Create and manage activity records (notes, emails, meetings) for persons.
  - name: Team Members
    description: List team members for use in search filters and assignments.
  - name: Custom Fields
    description: Retrieve custom field definitions and tag options for search filters.
  - name: Campaigns
    description: >-
      Create and edit email campaigns, enroll people through enrollment batches,
      and manage who is enrolled.
paths:
  /v1/meeting-recordings/{id}/share-links:
    post:
      tags:
        - Meeting Recordings
      summary: Create meeting recording share link
      description: >-
        Makes a recording public by creating a share link. Anyone with the
        returned `url` can watch the recording without signing in. Choose which
        sections the page shows with `show_summary`, `show_transcript` and
        `show_attendees` (all true by default). The summary defaults to the
        recording's current AI summary; pass `summary_markdown` to share an
        edited version. A recording can have several links, each with its own
        settings. Delete a link to stop sharing through it. API keys need the
        `meetings:write` scope to create or update links and `meetings:delete`
        to delete them. Session and OAuth callers can share recordings they can
        see.
      operationId: createMeetingRecordingShareLink
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            description: Meeting recording UUID
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MeetingRecordingShareLinkCreateRequest'
      responses:
        '201':
          description: Share link created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MeetingRecordingShareLinkResponse'
              example:
                success: true
                data:
                  id: weekly-engineering-sync-0b7c3f5e-8a41-4c2d-9e6f-3d2a1b0c9e87
                  recording_id: 5c6d7e8f-9012-3456-7890-abcdef012345
                  url: >-
                    https://stardex.com/share/startupxyz/recordings/weekly-engineering-sync-0b7c3f5e-8a41-4c2d-9e6f-3d2a1b0c9e87
                  title: Weekly Engineering Sync
                  summary_markdown: |-
                    ## Summary

                    - Discussed Q2 roadmap and deliverables.
                    - Agreed on hiring 2 senior engineers by May.

                    ## Next Steps

                    - Pranav to draft the JD.
                  show_summary: true
                  show_transcript: false
                  show_attendees: true
                  open_count: 3
                  created_by: 8f9e0d1c-2b3a-4c5d-8e7f-6a5b4c3d2e1f
                  created_at: '2026-04-07T11:20:00.000Z'
                  updated_at: '2026-04-08T09:15:00.000Z'
        '400':
          description: Validation error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    description: Always false for error responses.
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Machine-readable error code (e.g. "VALIDATION_ERROR",
                          "NOT_FOUND").
                      message:
                        type: string
                        description: Human-readable error description.
                      details:
                        type: object
                        additionalProperties: {}
                        description: >-
                          Extra facts about the error when they help you fix it,
                          such as a limit and when it resets.
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    description: Always false for error responses.
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Machine-readable error code (e.g. "VALIDATION_ERROR",
                          "NOT_FOUND").
                      message:
                        type: string
                        description: Human-readable error description.
                      details:
                        type: object
                        additionalProperties: {}
                        description: >-
                          Extra facts about the error when they help you fix it,
                          such as a limit and when it resets.
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                    description: Always false for error responses.
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        description: >-
                          Machine-readable error code (e.g. "VALIDATION_ERROR",
                          "NOT_FOUND").
                      message:
                        type: string
                        description: Human-readable error description.
                      details:
                        type: object
                        additionalProperties: {}
                        description: >-
                          Extra facts about the error when they help you fix it,
                          such as a limit and when it resets.
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
components:
  schemas:
    MeetingRecordingShareLinkCreateRequest:
      type: object
      properties:
        title:
          type: string
          minLength: 1
          maxLength: 1024
          description: >-
            Title shown on the public page. Defaults to the meeting title, or
            "Meeting Recording" when the meeting has none.
        summary_markdown:
          type: string
          maxLength: 100000
          description: >-
            Summary shown on the public page, in Markdown. Defaults to the
            recording's current AI summary. The link keeps its own copy, so
            later edits to the recording summary do not change it. Pass an empty
            string to share without a summary.
        show_summary:
          type: boolean
          default: true
          description: Show the meeting summary on the public page. Defaults to true.
        show_transcript:
          type: boolean
          default: true
          description: >-
            Show the transcript, and the button to copy it, on the public page.
            Defaults to true.
        show_attendees:
          type: boolean
          default: true
          description: Show the meeting attendees on the public page. Defaults to true.
        team_member_id:
          type: string
          format: uuid
          description: >-
            Team member UUID recorded as the creator of the link. Required with
            API-key auth, which has no user. Ignored with session or OAuth auth.
    MeetingRecordingShareLinkResponse:
      type: object
      properties:
        success:
          type: boolean
          enum:
            - true
        data:
          $ref: '#/components/schemas/MeetingRecordingShareLink'
      required:
        - success
        - data
    MeetingRecordingShareLink:
      type: object
      properties:
        id:
          type: string
          minLength: 1
          description: >-
            Share link ID, the last part of the public URL (for example
            `weekly-engineering-sync-0b7c3f5e-...`).
        recording_id:
          type: string
          format: uuid
          description: Meeting recording UUID.
        url:
          type: string
          description: >-
            Public URL of the shared recording. Anyone with the link can open it
            without signing in.
        title:
          type: string
          description: Title shown on the public page.
        summary_markdown:
          type:
            - string
            - 'null'
          description: >-
            Summary shown on the public page, in Markdown. Null or empty when
            the link has no summary.
        show_summary:
          type: boolean
          description: Show the meeting summary on the public page.
        show_transcript:
          type: boolean
          description: Show the transcript, and the button to copy it, on the public page.
        show_attendees:
          type: boolean
          description: Show the meeting attendees on the public page.
        open_count:
          type: integer
          description: How many times the public page was opened.
        created_by:
          type: string
          format: uuid
          description: UUID of the team member who created the link.
        created_at:
          type: string
          description: ISO 8601 creation timestamp.
        updated_at:
          type: string
          description: ISO 8601 last update timestamp.
      required:
        - id
        - recording_id
        - url
        - title
        - summary_markdown
        - show_summary
        - show_transcript
        - show_attendees
        - open_count
        - created_by
        - created_at
        - updated_at
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Authenticate with a Bearer token: API key, OAuth token, or session
        token.

````

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