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

# Transitive downstream blast radius (repo-level BFS). NOT file-path scoped — accepts only `max_depth` + `min_confidence`.

> Get the full downstream impact of changing this repository.

Returns all repositories that depend on this one, directly or transitively,
up to ``max_depth`` hops away. Use this before publishing a breaking change.

**Repo-level scope, not file-scoped.** This endpoint computes a BFS over
repo-to-repo dependency edges; it does **not** trace specific files, jobs,
or symbols within the source repo. There is no ``path``, ``paths``,
``file``, or ``job`` query parameter — agents asking "who consumes file X
in repo Y" should call ``/repositories/{id}/dependents`` and then grep the
consumer repos directly, since per-file edges aren't stored in the graph.
Unknown query parameters are silently ignored by FastAPI, which can mask
hallucinated filter names — if a filter doesn't appear in this signature,
it's not honoured.

For artifact-level consumers (who pulls Docker image / Helm chart /
Terraform module X and at what version), use ``/artifacts/{id}/consumers``
instead — that endpoint *is* version-aware.



## OpenAPI

````yaml /openapi.json get /api/v1/repositories/{repo_id}/impact
openapi: 3.1.0
info:
  description: Change Impact Engine for multi-repo systems
  title: Riftmap
  version: 1.7.5
servers: []
security: []
paths:
  /api/v1/repositories/{repo_id}/impact:
    get:
      tags:
        - impact
      summary: >-
        Transitive downstream blast radius (repo-level BFS). NOT file-path
        scoped — accepts only `max_depth` + `min_confidence`.
      description: >-
        Get the full downstream impact of changing this repository.


        Returns all repositories that depend on this one, directly or
        transitively,

        up to ``max_depth`` hops away. Use this before publishing a breaking
        change.


        **Repo-level scope, not file-scoped.** This endpoint computes a BFS over

        repo-to-repo dependency edges; it does **not** trace specific files,
        jobs,

        or symbols within the source repo. There is no ``path``, ``paths``,

        ``file``, or ``job`` query parameter — agents asking "who consumes file
        X

        in repo Y" should call ``/repositories/{id}/dependents`` and then grep
        the

        consumer repos directly, since per-file edges aren't stored in the
        graph.

        Unknown query parameters are silently ignored by FastAPI, which can mask

        hallucinated filter names — if a filter doesn't appear in this
        signature,

        it's not honoured.


        For artifact-level consumers (who pulls Docker image / Helm chart /

        Terraform module X and at what version), use
        ``/artifacts/{id}/consumers``

        instead — that endpoint *is* version-aware.
      operationId: repository_impact_api_v1_repositories__repo_id__impact_get
      parameters:
        - in: path
          name: repo_id
          required: true
          schema:
            format: uuid
            title: Repo Id
            type: string
        - description: >-
            Maximum BFS depth (hops from the source repo). Range 1–20, default
            10.
          in: query
          name: max_depth
          required: false
          schema:
            default: 10
            description: >-
              Maximum BFS depth (hops from the source repo). Range 1–20, default
              10.
            maximum: 20
            minimum: 1
            title: Max Depth
            type: integer
        - description: >-
            Minimum edge confidence to traverse. Default 0.8 excludes heuristic
            findings (0.4–0.7) and only follows deterministic dependency edges.
            Set to 0.0 to include all edges.
          in: query
          name: min_confidence
          required: false
          schema:
            default: 0.8
            description: >-
              Minimum edge confidence to traverse. Default 0.8 excludes
              heuristic findings (0.4–0.7) and only follows deterministic
              dependency edges. Set to 0.0 to include all edges.
            maximum: 1
            minimum: 0
            title: Min Confidence
            type: number
        - in: header
          name: X-Workspace-Id
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Workspace-Id
        - in: cookie
          name: riftmap_access
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Riftmap Access
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ImpactResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - APIKeyHeader: []
        - HTTPBearer: []
components:
  schemas:
    ImpactResponse:
      description: Full downstream impact of changing a repository.
      properties:
        affected_repositories:
          items:
            $ref: '#/components/schemas/AffectedRepository'
          title: Affected Repositories
          type: array
        max_depth_reached:
          title: Max Depth Reached
          type: integer
        source_repository:
          additionalProperties: true
          title: Source Repository
          type: object
        total_affected:
          title: Total Affected
          type: integer
      required:
        - source_repository
        - affected_repositories
        - total_affected
        - max_depth_reached
      title: ImpactResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    AffectedRepository:
      description: A repository affected by a change to the source repository.
      properties:
        confidence:
          title: Confidence
          type: number
        depth:
          title: Depth
          type: integer
        full_path:
          title: Full Path
          type: string
        id:
          format: uuid
          title: Id
          type: string
        name:
          title: Name
          type: string
      required:
        - id
        - name
        - full_path
        - depth
        - confidence
      title: AffectedRepository
      type: object
    ValidationError:
      properties:
        ctx:
          title: Context
          type: object
        input:
          title: Input
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    APIKeyHeader:
      in: header
      name: X-API-Key
      type: apiKey
    HTTPBearer:
      description: API key as Bearer token (rfm_live_... prefix)
      scheme: bearer
      type: http

````