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

# Fetch investigation results by ID (UUID)

> Retrieves detailed investigation results including root cause analysis and remediation steps



## OpenAPI

````yaml /assets/openapi.mintlify.json get /issues/{id}/results
openapi: 3.0.0
info:
  title: Antimetal External API
  description: >-
    Public-facing API for external integrations with Antimetal. Provides
    programmatic access to issue investigation, results, artifacts, and chat
    functionality.
  version: '2026-03-17'
  contact: {}
servers:
  - url: https://bff.antimetal.com/api/v2
    description: Production API
  - url: https://bff.dev.antimetal.com/api/v2
    description: Dev API
security:
  - bearer: []
tags: []
paths:
  /issues/{id}/results:
    get:
      tags:
        - Issues
      summary: Fetch investigation results by ID (UUID)
      description: >-
        Retrieves detailed investigation results including root cause analysis
        and remediation steps
      operationId: getIssueResults
      parameters:
        - $ref: '#/components/parameters/AntimetalVersion'
        - name: version
          required: false
          in: query
          description: Issue version for workflow results (defaults to latest)
          schema:
            type: integer
            format: int32
            minimum: 1
        - name: id
          required: true
          in: path
          description: Issue unique identifier (UUID)
          schema:
            type: string
            format: uuid
            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      responses:
        '200':
          description: Investigation results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IssueResultsDto'
        '400':
          description: Validation error or bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '403':
          description: Insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
      x-codeSamples:
        - lang: JavaScript
          source: >-
            import Antimetal from '@antimetal/sdk';


            const client = new Antimetal({
              apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted
            });


            const result = await
            client.issues.results.retrieve('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');


            console.log(result.sessionUuid);
components:
  parameters:
    AntimetalVersion:
      name: Antimetal-Version
      in: header
      required: false
      description: >-
        The API version to use. Defaults to the latest stable version if
        omitted. Pin to the version string in this document's `info.version`
        field to opt into exactly this version's schema.
      schema:
        type: string
        example: '2026-03-17'
        default: '2026-03-17'
  schemas:
    IssueResultsDto:
      type: object
      properties:
        sessionUuid:
          description: Session UUID for live investigation
          nullable: true
          type: string
        rootCause:
          description: Root cause information
          nullable: true
          type: object
          properties:
            id:
              type: string
              description: Root cause identifier
            incidentOverview:
              type: string
              description: Root cause problem overview
            rootCauseSummary:
              type: string
              description: Root cause analysis summary
            relevantEvidence:
              type: array
              items:
                type: object
                properties:
                  title:
                    type: string
                    description: Evidence title
                  status:
                    type: string
                    enum:
                      - relevant
                      - irrelevant
                      - inconclusive
                    description: Evidence status
                  description:
                    type: string
                    description: Evidence description
                  confidence:
                    type: string
                    enum:
                      - unknown
                      - unclear
                      - probable
                      - likely
                      - confirmed
                    description: Evidence confidence level
                  artifacts:
                    type: array
                    items:
                      type: object
                      properties:
                        documentId:
                          type: string
                          description: Document identifier for artifact fetching
                        title:
                          type: string
                          description: Artifact title
                        description:
                          type: string
                          description: Artifact description
                        dataType:
                          type: string
                          description: Type of data in this artifact
                      required:
                        - documentId
                        - title
                        - description
                        - dataType
                    description: Evidence artifacts with document references
                required:
                  - title
                  - status
                  - description
                  - confidence
                  - artifacts
              description: Relevant evidence supporting the root cause
            irrelevantEvidence:
              type: array
              items:
                type: object
                properties:
                  title:
                    type: string
                    description: Evidence title
                  status:
                    type: string
                    enum:
                      - relevant
                      - irrelevant
                      - inconclusive
                    description: Evidence status
                  description:
                    type: string
                    description: Evidence description
                  confidence:
                    type: string
                    enum:
                      - unknown
                      - unclear
                      - probable
                      - likely
                      - confirmed
                    description: Evidence confidence level
                  artifacts:
                    type: array
                    items:
                      type: object
                      properties:
                        documentId:
                          type: string
                          description: Document identifier for artifact fetching
                        title:
                          type: string
                          description: Artifact title
                        description:
                          type: string
                          description: Artifact description
                        dataType:
                          type: string
                          description: Type of data in this artifact
                      required:
                        - documentId
                        - title
                        - description
                        - dataType
                    description: Evidence artifacts with document references
                required:
                  - title
                  - status
                  - description
                  - confidence
                  - artifacts
              description: Irrelevant evidence ruled out during investigation
          required:
            - id
            - incidentOverview
            - rootCauseSummary
            - relevantEvidence
            - irrelevantEvidence
        causalTree:
          type: object
          properties:
            nodes:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    description: Unique identifier for this node.
                  type:
                    type: string
                    enum:
                      - validated
                      - needs-context
                      - ruled-out
                    description: Node type indicating its state in the causal analysis
                  title:
                    type: string
                    description: Short title of the node
                  description:
                    type: string
                    description: Detailed description of the node
                  expandedContent:
                    description: >-
                      Optional rich text content in Markdown format providing
                      detailed explanation
                    type: string
                required:
                  - id
                  - type
                  - title
                  - description
            edges:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    description: Unique identifier for this edge
                  source:
                    type: string
                    description: ID of the source node
                  target:
                    type: string
                    description: ID of the target node
                required:
                  - id
                  - source
                  - target
          required:
            - nodes
            - edges
          description: Causal tree analysis
        causalTreeV2:
          type: object
          properties:
            nodes:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    description: >-
                      Unique identifier for this node in the causal graph
                      (causal variable) e.g. db_connection_error or
                      deployment_change.
                  title:
                    type: string
                    description: >-
                      Brief display name for the causal variable. Use active
                      verbs to show causal flow. CAUSE nodes: action-focused
                      (e.g., 'Flag Activates Bad Store Routing', 'Deployment
                      Introduces Memory Leak'). MEDIATOR nodes:
                      consequence-focused (e.g., 'Requests Routed to Invalid
                      Endpoint', 'Memory Exhaustion Occurs'). OUTCOME nodes:
                      consequence-focused (e.g., 'Service Errors Exceed
                      Threshold', 'Response Times Degrade Beyond SLA'). Keep
                      under 8 words.
                  description:
                    type: string
                    description: >-
                      Succinct explanation (1-2 sentences, ~30 words) describing
                      what the underlying evidence shows and the node's role in
                      the incident. Use technical precision: include service
                      names, error codes, field names, file paths. Use direct
                      factual statements without explanations. Skip discovery
                      details - focus on what happened, not how it was found.
                      Include causal mechanism if relevant. Example:
                      'Configuration shows paymentFailure flag enabled at 12.5%
                      rate, implementing probabilistic failure injection via
                      Math.random() in charge.js:37.' Let evidence documents
                      contain detailed data.
                  confidence:
                    type: string
                    enum:
                      - unknown
                      - unclear
                      - probable
                      - likely
                      - confirmed
                    description: >-
                      Confidence in this node's role in the incident (e.g., how
                      certain we are that this factor accurately represents what
                      happened)
                  nodeType:
                    type: string
                    enum:
                      - outcome
                      - cause
                      - confounder
                      - mediator
                    description: >-
                      Role in the causal graph: OUTCOME = the problem you're
                      investigating, CAUSE = what triggered it, CONFOUNDER =
                      external factor affecting multiple variables, MEDIATOR =
                      intermediate step in the causal path
                  evidence:
                    type: array
                    items:
                      type: object
                      properties:
                        documentId:
                          type: string
                          description: >-
                            Unique identifier for the document that contains
                            this evidence (e.g.,
                            'log:datadog:a9c1319258284740a7e5704134d90238',
                            'trace:gcp:abc123',
                            'file:github:24192d3b6c1292fd29da76ada910c175')
                        title:
                          type: string
                          minLength: 1
                          description: >-
                            Human-readable name for this piece of evidence
                            (e.g., 'Unbounded Cache Growth in
                            recommendation_server.py', 'Deployment memory limit
                            configuration','Deploy Script v2.1')
                        description:
                          type: string
                          minLength: 1
                          description: >-
                            Direct factual statement about what the evidence
                            shows and why it's relevant to the causal
                            relationship (e.g., 'Shows 300% CPU spike at 14:23,
                            correlating with error rate increase')
                        dataType:
                          type: string
                          description: >-
                            Type of artifact extracted from documentId (log,
                            metric, trace, file, etc.)
                      required:
                        - documentId
                        - title
                        - description
                        - dataType
                required:
                  - id
                  - title
                  - description
                  - confidence
                  - nodeType
                  - evidence
            edges:
              type: array
              items:
                type: object
                properties:
                  from:
                    type: string
                    description: Unique identifier for the source node in the causal graph.
                  to:
                    type: string
                    description: Unique identifier for the target node in the causal graph.
                  confidence:
                    type: number
                    minimum: 0
                    maximum: 1
                    description: >-
                      Edge confidence reflects how certain we are about the
                      causal relationship itself (e.g. how confident we are that
                      the deployment caused the memory leak).
                required:
                  - from
                  - to
                  - confidence
          required:
            - nodes
            - edges
          description: Causal graph V2 with enriched evidence
        remediation:
          type: object
          properties:
            actions:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    description: Action identifier
                  uuid:
                    type: string
                    description: Action UUID
                  title:
                    type: string
                    description: Action title
                  description:
                    description: Optional action description
                    type: string
                  category:
                    description: >-
                      Remediation category: immediate (quick stabilization),
                      root_cause (fixes underlying issue), preventative
                      (prevents recurrence)
                    type: string
                    enum:
                      - immediate
                      - root_cause
                      - preventative
                  steps:
                    type: array
                    items:
                      oneOf:
                        - type: object
                          properties:
                            id:
                              type: string
                              description: Step identifier
                            title:
                              type: string
                              description: Step title
                            helpMarkdown:
                              description: Optional help text in markdown
                              type: string
                            required:
                              type: boolean
                              description: Whether this step is required
                            label:
                              description: Optional label for the step
                              type: string
                            type:
                              type: string
                              description: Info step type
                              enum:
                                - info
                            content:
                              type: string
                              description: Markdown content to display
                          required:
                            - id
                            - title
                            - required
                            - type
                            - content
                        - type: object
                          properties:
                            id:
                              type: string
                              description: Step identifier
                            title:
                              type: string
                              description: Step title
                            helpMarkdown:
                              description: Optional help text in markdown
                              type: string
                            required:
                              type: boolean
                              description: Whether this step is required
                            label:
                              description: Optional label for the step
                              type: string
                            type:
                              type: string
                              description: Code step type
                              enum:
                                - code
                            files:
                              type: array
                              items:
                                type: object
                                properties:
                                  filename:
                                    type: string
                                    description: Name of the code file
                                  language:
                                    description: >-
                                      Programming language for syntax
                                      highlighting
                                    type: string
                                  content:
                                    type: string
                                    description: File content
                                required:
                                  - filename
                                  - content
                              description: Array of code files to modify
                            activeFilename:
                              description: Currently active/selected filename
                              type: string
                          required:
                            - id
                            - title
                            - required
                            - type
                            - files
                        - type: object
                          properties:
                            id:
                              type: string
                              description: Step identifier
                            title:
                              type: string
                              description: Step title
                            helpMarkdown:
                              description: Optional help text in markdown
                              type: string
                            required:
                              type: boolean
                              description: Whether this step is required
                            label:
                              description: Optional label for the step
                              type: string
                            type:
                              type: string
                              description: CLI step type
                              enum:
                                - cli
                            command:
                              type: string
                              description: Shell command to execute
                          required:
                            - id
                            - title
                            - required
                            - type
                            - command
                    description: Array of remediation steps
                  markdownPrompt:
                    description: Markdown prompt describing the suggested steps
                    type: string
                required:
                  - id
                  - uuid
                  - title
                  - steps
              description: Available remediation actions
          required:
            - actions
          description: Remediation actions and steps
        timeline:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
                enum:
                  - outcome
                  - cause
                  - confounder
                  - mediator
                nullable: true
              timestamp:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                nullable: true
              title:
                type: string
              description:
                type: string
              evidence:
                type: array
                items:
                  type: object
                  properties:
                    artifactId:
                      type: string
                      nullable: true
                    timestamp:
                      type: string
                      format: date-time
                      pattern: >-
                        ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                      nullable: true
                    title:
                      type: string
                    description:
                      type: string
                  required:
                    - artifactId
                    - timestamp
                    - title
                    - description
            required:
              - id
              - type
              - timestamp
              - title
              - description
              - evidence
          description: Timeline events
      required:
        - sessionUuid
        - rootCause
        - causalTree
        - causalTreeV2
        - remediation
        - timeline
    ErrorResponseDto:
      type: object
      properties:
        type:
          type: string
          enum:
            - api_error
            - invalid_request_error
            - authentication_error
          description: Error type classification
        message:
          type: string
          description: Human-readable error message
        request_id:
          type: string
          description: Request correlation ID for tracing and support
        details:
          description: Detailed field-level validation errors (for 400/422 responses)
          type: object
          additionalProperties:
            type: string
      required:
        - type
        - message
        - request_id
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: API key authentication via Bearer token

````