> ## 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 it. 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 it. 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.
      description: >-
        Request body to get a run's public share link. Only `projectShortId` is
        needed, and only for org-scoped keys.
    ShareRunResponse:
      type: object
      required:
        - success
        - run
        - shareUrl
      properties:
        success:
          type: boolean
        run:
          $ref: '#/components/schemas/ShareRunRun'
        shareUrl:
          type: string
          description: >-
            Public read-only URL for the run. Anyone with the link can view the
            run and its test results without signing in.
    ProjectShortId:
      type: string
      pattern: ^proj(-.+_.+|_.+)$
    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.