Graphify API

openapi: 3.1.0
info:
  title: Graphify API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 4 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Graphify has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 1
    pages-with-code: 4
    pages-read: 5
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-10'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.graphify.com/open-source/mcp-server.md
  - https://docs.graphify.com/open-source/installation.md
  - https://docs.graphify.com/open-source/troubleshooting.md
  - https://docs.graphify.com/platform/graphify-mcp
  - https://docs.graphify.com/platform/test-impact
servers:
- url: https://api.graphify.com
paths:
  /mcp:
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: POST /mcp
      x-source: https://docs.graphify.com/open-source/mcp-server.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s -o /dev/null -w "%{http_code}\n" -X POST http://127.0.0.1:8099/mcp  -H "Authorization: Bearer $GRAPHIFY_API_KEY"  -H
          "Content-Type: application/json" -H "Accept: application/json, text/event-stream"  -d ''{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}''

          ```'
  /mcp/server-card:
    get:
      operationId: get_mcp_server_card
      tags:
      - Mcp
      summary: GET /mcp/server-card
      x-source: https://docs.graphify.com/platform/graphify-mcp
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -H \"Accept: application/mcp-server-card+json\" https://api.graphify.com/mcp/server-card \n ​ Other discovery endpoints\
          \ \n These public files tell a client how to sign in. Your client reads them for you. \n Endpoint What it describes /.well-known/oauth-protected-resource/mcp\
          \ The MCP server, its sign-in server, and the graphify:query scope. /.well-known/oauth-authorization-server Sign-in, token, re"
  /uv/install.sh:
    get:
      operationId: get_uv_install_sh
      tags:
      - Uv
      summary: GET /uv/install.sh
      x-source: https://docs.graphify.com/open-source/installation.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -LsSf https://astral.sh/uv/install.sh | sh

          ```'
  /v1/repos/{repositoryid}/test-impact:
    post:
      operationId: post_v1_repos_repositoryid_test_impact
      tags:
      - Repos
      summary: Your CI calls POST https://api.graphify.com/v1/repos/{repositoryId}/test-impact with the token as a bearer token.
      x-source: https://docs.graphify.com/platform/test-impact
      parameters:
      - name: repositoryid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ReposRepositoryidTestImpactRequest'
      responses:
        '2000':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ReposRepositoryidTestImpactResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
        id:
          type: integer
        method:
          type: string
        params:
          type: object
          properties:
            protocolVersion:
              type: string
              format: date
            capabilities:
              type: object
            clientInfo:
              type: object
              properties:
                name:
                  type: string
                version:
                  type: string
    PostV1ReposRepositoryidTestImpactRequest:
      type: object
      properties:
        changedFiles:
          type: string
          description: Up to 2,000 paths, each up to 1,024 characters. Duplicates are removed. An empty list runs the full suite.
        deletedFiles:
          type: string
          description: Up to 2,000 paths. Not allowed with a commit range.
        renames:
          type: object
          description: Array of objects with old and new fields. Up to 2,000 pairs. Not allowed with a commit range.
        baseSha:
          type: string
          description: Hex commit SHA, 7 to 64 characters. Send both or neither.
        headSha:
          type: string
          description: Hex commit SHA, 7 to 64 characters. Send both or neither.
        format:
          type: string
          description: 'buildkite or json. Default: buildkite.'
        command:
          type: string
          description: The test command for the generated steps, up to 200 characters.
    PostV1ReposRepositoryidTestImpactResponse:
      type: object
      properties:
        steps:
          type: object
          description: When format=buildkite, the response is a Buildkite pipeline JSON with a steps array.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Mcp
- name: Repos
- name: Uv