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

# Share run

> Returns a public, read-only link to a run that anyone can open without signing in, the same as Share in the dashboard. Reuses the run's existing link if it has one, otherwise creates the plain run link. Pass `audience` `sales` for the sales report shown to the owner of the tested site — its address and how to reach QA.tech. That is limited to QA.tech admins. A run has one link, so `sales` changes what an existing link shows; omit `audience` to leave it unchanged. Pass `audience` `general` to switch a sales report back to the plain run, which is also limited to QA.tech admins. Disable the link from the run page in the dashboard.



## OpenAPI

````yaml /api-reference/api.json post /v1/run/{shortId}/share
openapi: 3.0.0
info:
  title: QA.tech API
  version: 1.0.0
  contact:
    name: QA.tech
    url: https://qa.tech
    email: support@qa.tech
  description: API for triggering and managing AI-powered test runs
servers:
  - url: https://api.qa.tech
    description: Production
    variables: {}
security:
  - BearerAuth: []
tags:
  - name: Runs
  - name: Infrastructure
  - name: Test Cases
  - name: Application Builds
  - name: Status badge
  - name: Remote Tunnels
  - name: Chat
  - name: Applications
  - name: Features
  - name: Metrics
  - name: Projects
  - name: Knowledge
  - name: Rules
  - name: Configs
  - name: Labels
  - name: Scenarios
  - name: Issues
  - name: Todos
  - name: Automations
  - name: Test plans
paths:
  /v1/run/{shortId}/share:
    post:
      tags:
        - Runs
      summary: Share run
      description: >-
        Returns a public, read-only link to a run that anyone can open without
        signing in, the same as Share in the dashboard. Reuses the run's
        existing link if it has one, otherwise creates the plain run link. Pass
        `audience` `sales` for the sales report shown to the owner of the tested
        site — its address and how to reach QA.tech. That is limited to QA.tech
        admins. A run has one link, so `sales` changes what an existing link
        shows; omit `audience` to leave it unchanged. Pass `audience` `general`
        to switch a sales report back to the plain run, which is also limited to
        QA.tech admins. Disable the link from the run page in the dashboard.
      operationId: ShareRunOp
      parameters:
        - name: shortId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ShareRunRequest'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShareRunResponse'
components:
  schemas:
    ShareRunRequest:
      type: object
      properties:
        projectShortId:
          allOf:
            - $ref: '#/components/schemas/ProjectShortId'
          description: >-
            Target a specific project by its prefixed short ID
            (proj-slug_shortId or proj_shortId), as returned by the projects
            API. Required for organization-scoped API keys; project-scoped keys
            may only pass their own project's short ID.
        audience:
          allOf:
            - $ref: '#/components/schemas/RunShareAudience'
          description: >-
            What the link shows. Omit it to create the plain run link, or to
            leave an existing link unchanged. `sales` switches the link to the
            sales report and is limited to QA.tech admins. `general` switches it
            back to the plain run, which is also limited to QA.tech admins when
            the link currently shows the sales report.
      description: >-
        Request body for a run's public share link. Only `projectShortId` is
        needed for the plain link, and only for org-scoped keys.
    ShareRunResponse:
      type: object
      required:
        - success
        - run
        - audience
        - shareUrl
      properties:
        success:
          type: boolean
        run:
          $ref: '#/components/schemas/ShareRunRun'
        audience:
          allOf:
            - $ref: '#/components/schemas/RunShareAudience'
          description: >-
            What the link shows right now: `general` for the plain run, or
            `sales` for the sales report.
        shareUrl:
          type: string
          description: >-
            Public URL for the run. Anyone with the link can open it without
            signing in. What they see depends on `audience`.
    ProjectShortId:
      type: string
      pattern: ^proj(-.+_.+|_.+)$
    RunShareAudience:
      type: string
      enum:
        - general
        - sales
      description: >-
        What a run's public link shows. A run has one link, so changing this
        changes what an existing link shows.
    ShareRunRun:
      type: object
      required:
        - id
        - shortId
        - url
      properties:
        id:
          type: string
        shortId:
          type: string
        url:
          type: string
          description: Dashboard URL for the run. Requires signing in to the organization.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: Bearer

````

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