LogRocket Graph QL API

openapi: 3.2.0
info:
  title: LogRocket Data Export Graph QL API
  description: The LogRocket GraphQL API allows developers to query session replay and analytics data using GraphQL. It provides a flexible query interface for retrieving session information, user activity, error details, and performance metrics. Developers can use this API to build custom dashboards, integrate session data into internal tools, and perform advanced filtering and aggregation of LogRocket monitoring data.
  version: '1.0'
  contact:
    name: LogRocket Support
    url: https://logrocket.com/support
  termsOfService: https://logrocket.com/terms
servers:
- url: https://api.logrocket.com
  description: LogRocket Production API
security:
- tokenAuth: []
tags:
- name: Graph QL
  description: GraphQL endpoint for querying session replay and analytics data.
paths:
  /graphql:
    post:
      operationId: executeGraphQLQuery
      summary: Execute a GraphQL query
      description: Executes a GraphQL query or mutation against the LogRocket data model. Supports queries for sessions, users, errors, performance metrics, and other monitoring data. Use the GraphQL introspection query to discover the available schema, types, and fields.
      tags:
      - Graph QL
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GraphQLRequest'
      responses:
        '200':
          description: GraphQL query executed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GraphQLResponse'
        '400':
          description: Malformed GraphQL query or invalid variables.
        '401':
          description: Missing or invalid API key.
components:
  schemas:
    GraphQLResponse:
      type: object
      description: A standard GraphQL response containing data and optional errors.
      properties:
        data:
          type: object
          description: The result of the executed query. Structure depends on the fields requested in the query.
          additionalProperties: true
        errors:
          type: array
          description: Array of errors encountered during query execution.
          items:
            $ref: '#/components/schemas/GraphQLError'
    GraphQLError:
      type: object
      description: A GraphQL error returned when a query fails partially or completely.
      properties:
        message:
          type: string
          description: Human-readable description of the error.
        locations:
          type: array
          description: Locations in the query where the error occurred.
          items:
            type: object
            properties:
              line:
                type: integer
                description: The line number in the query.
              column:
                type: integer
                description: The column number in the query.
        path:
          type: array
          description: Path to the field that caused the error.
          items:
            type: string
        extensions:
          type: object
          description: Additional error metadata.
          additionalProperties: true
    GraphQLRequest:
      type: object
      description: A standard GraphQL request containing a query string and optional variables and operation name.
      required:
      - query
      properties:
        query:
          type: string
          description: The GraphQL query or mutation string to execute.
        variables:
          type: object
          description: Variables to substitute into the GraphQL query.
          additionalProperties: true
        operationName:
          type: string
          description: The name of the operation to execute when the query contains multiple operations.
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API token authentication. Use the format "token <your-api-key>". API keys are available from the LogRocket dashboard under Settings > General Settings.
externalDocs:
  description: LogRocket GraphQL API Documentation
  url: https://docs.logrocket.com/reference/graphql-1