> ## Documentation Index > Fetch the complete documentation index at: https://evalgate.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create repository intelligence scans > Requires scopes: eval:write ## OpenAPI ````yaml /api-reference/openapi.json post /api/repository-intelligence/repositories/{repositoryId}/scans openapi: 3.1.0 info: title: EvalGate API version: 3.7.6 description: EvalGate API. See docs/api-contract.md for stability commitments. servers: - url: https://evalgate.com description: Production - url: http://localhost:3000 description: Local security: [] paths: /api/repository-intelligence/repositories/{repositoryId}/scans: post: tags: - repository intelligence summary: Create repository intelligence scans description: 'Requires scopes: eval:write' operationId: post_repository_intelligence_repositories_repositoryId_scans parameters: - name: repositoryId in: path required: true schema: type: string requestBody: required: true content: application/json: schema: $ref: >- #/components/schemas/PostApiRepositoryIntelligenceRepositoriesRepositoryIdScansRequest responses: '200': description: Successful response content: application/json: schema: $ref: >- #/components/schemas/PostApiRepositoryIntelligenceRepositoriesRepositoryIdScansResponse200ApplicationJson '201': description: Successful response content: application/json: schema: $ref: >- #/components/schemas/PostApiRepositoryIntelligenceRepositoriesRepositoryIdScansResponse201ApplicationJson '400': $ref: '#/components/responses/ValidationError' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' security: - bearerAuth: - eval:write components: schemas: PostApiRepositoryIntelligenceRepositoriesRepositoryIdScansRequest: type: object properties: idempotencyKey: type: string headSha: type: string additionalProperties: false required: - idempotencyKey PostApiRepositoryIntelligenceRepositoriesRepositoryIdScansResponse200ApplicationJson: oneOf: - type: object properties: scanRun: type: object properties: id: type: string organizationId: $ref: '#/components/schemas/OrganizationId' repositoryId: type: number snapshotId: type: string status: type: string completeness: oneOf: - type: string enum: - failed - type: string enum: - complete - type: string enum: - partial idempotencyKey: type: string detectorRegistryHash: type: string manifestHash: type: string graphVersionId: oneOf: - type: 'null' - type: string fileCount: type: number factCount: type: number relationCount: type: number warnings: type: array items: type: string startedAt: type: string format: date-time completedAt: oneOf: - type: 'null' - type: string format: date-time additionalProperties: false required: - id - organizationId - repositoryId - snapshotId - status - completeness - idempotencyKey - detectorRegistryHash - manifestHash - graphVersionId - fileCount - factCount - relationCount - warnings - startedAt - completedAt existing: type: boolean enum: - true inventory: type: 'null' additionalProperties: false required: - scanRun - existing - type: object properties: scanRun: type: object properties: status: type: string id: type: string organizationId: $ref: '#/components/schemas/OrganizationId' repositoryId: type: number manifestHash: type: string startedAt: type: string format: date-time completedAt: oneOf: - type: 'null' - type: string format: date-time idempotencyKey: type: string warnings: type: array items: type: string completeness: oneOf: - type: string enum: - failed - type: string enum: - complete - type: string enum: - partial graphVersionId: oneOf: - type: 'null' - type: string snapshotId: type: string detectorRegistryHash: type: string fileCount: type: number factCount: type: number relationCount: type: number additionalProperties: false required: - status - id - organizationId - repositoryId - manifestHash - startedAt - completedAt - idempotencyKey - warnings - completeness - graphVersionId - snapshotId - detectorRegistryHash - fileCount - factCount - relationCount existing: type: boolean enum: - false inventory: type: object properties: facts: type: array items: type: object properties: type: oneOf: - type: string enum: - policy - type: string enum: - owner - type: string enum: - prompt - type: string enum: - model_binding - type: string enum: - workflow - type: string enum: - dataset - type: string enum: - guardrail - type: string enum: - evaluator - type: string enum: - agent - type: string enum: - runtime - type: string enum: - baseline - type: string enum: - tool - type: string enum: - repository - type: string enum: - repository_snapshot - type: string enum: - workspace - type: string enum: - package - type: string enum: - source_file - type: string enum: - code_symbol - type: string enum: - ai_system - type: string enum: - business_objective_candidate - type: string enum: - business_objective - type: string enum: - requirement - type: string enum: - model_provider - type: string enum: - model_route - type: string enum: - mcp_server - type: string enum: - connector - type: string enum: - retrieval_pipeline - type: string enum: - corpus - type: string enum: - index - type: string enum: - embedding_model - type: string enum: - reranker - type: string enum: - memory_store - type: string enum: - memory_policy - type: string enum: - permission_boundary - type: string enum: - eval_suite - type: string enum: - test_case - type: string enum: - ci_workflow - type: string enum: - release_artifact - type: string enum: - deployment_target - type: string enum: - trace_stream - type: string enum: - production_monitor - type: string enum: - risk - type: string enum: - coverage_gap - type: string enum: - pull_request - type: string enum: - change_set stableKey: type: string label: type: string description: type: string confidence: type: number method: oneOf: - type: string enum: - workflow - type: string enum: - manifest - type: string enum: - dependency - type: string enum: - syntax - type: string enum: - static_flow - type: string enum: - configuration - type: string enum: - convention - type: string enum: - runtime_link - type: string enum: - model_inference - type: string enum: - human_confirmation sourceLocators: type: array items: type: object properties: path: type: string repositoryId: type: number commitSha: type: string blobSha: type: string contentHash: type: string startLine: type: number endLine: type: number language: type: string startColumn: type: number endColumn: type: number symbolKey: type: string protectedExcerptHash: type: string additionalProperties: false required: - path - repositoryId - commitSha - blobSha properties: type: object additionalProperties: oneOf: - type: 'null' - type: string - type: number - type: boolean enum: - false - type: boolean enum: - true - type: array items: type: string - type: array items: type: number additionalProperties: false required: - type - stableKey - label - confidence - method relations: type: array items: type: object properties: sourceKey: type: string targetKey: type: string relation: oneOf: - type: string enum: - contains - type: string enum: - verified_by - type: string enum: - defines - type: string enum: - imports - type: string enum: - calls - type: string enum: - invokes - type: string enum: - routes_to - type: string enum: - uses_model - type: string enum: - uses_prompt - type: string enum: - exposes_tool - type: string enum: - connects_to - type: string enum: - retrieves_from - type: string enum: - indexes - type: string enum: - embeds_with - type: string enum: - reranks_with - type: string enum: - reads_memory - type: string enum: - writes_memory - type: string enum: - guarded_by - type: string enum: - authorized_by - type: string enum: - evaluated_by - type: string enum: - covered_by - type: string enum: - gated_by - type: string enum: - monitored_by - type: string enum: - deploys_to - type: string enum: - owned_by - type: string enum: - affects - type: string enum: - satisfies - type: string enum: - lacks_coverage_for - type: string enum: - derived_from - type: string enum: - changed_by - type: string enum: - failed_in - type: string enum: - repaired_by - type: string enum: - published_as - type: string enum: - supersedes confidence: type: number additionalProperties: false required: - sourceKey - targetKey - relation - confidence packRecommendations: type: array items: type: object properties: packId: type: string packVersion: type: string domain: oneOf: - type: string enum: - healthcare - type: string enum: - legal - type: string enum: - support - type: string enum: - coding - type: string enum: - financial confidence: type: number priority: oneOf: - type: string enum: - required - type: string enum: - recommended - type: string enum: - consider reasonCodes: type: array items: type: string explanation: type: string evidence: type: array items: type: object properties: stableKey: type: string label: type: string confidence: type: number sourceLocators: type: array items: type: object properties: path: type: string repositoryId: type: number commitSha: type: string blobSha: type: string contentHash: type: string startLine: type: number endLine: type: number language: type: string startColumn: type: number endColumn: type: number symbolKey: type: string protectedExcerptHash: type: string additionalProperties: false required: - path - repositoryId - commitSha - blobSha additionalProperties: false required: - stableKey - label - confidence - sourceLocators coverageState: oneOf: - type: string enum: - installed - type: string enum: - uncovered additionalProperties: false required: - packId - packVersion - domain - confidence - priority - reasonCodes - explanation - evidence - coverageState tree: type: object properties: entryCount: type: number contentCandidateCount: type: number analyzedFileCount: type: number truncated: type: boolean additionalProperties: false required: - entryCount - contentCandidateCount - analyzedFileCount - truncated additionalProperties: false required: - facts - relations - packRecommendations - tree additionalProperties: false required: - scanRun - existing - inventory PostApiRepositoryIntelligenceRepositoriesRepositoryIdScansResponse201ApplicationJson: oneOf: - type: object properties: scanRun: type: object properties: id: type: string organizationId: $ref: '#/components/schemas/OrganizationId' repositoryId: type: number snapshotId: type: string status: type: string completeness: oneOf: - type: string enum: - failed - type: string enum: - complete - type: string enum: - partial idempotencyKey: type: string detectorRegistryHash: type: string manifestHash: type: string graphVersionId: oneOf: - type: 'null' - type: string fileCount: type: number factCount: type: number relationCount: type: number warnings: type: array items: type: string startedAt: type: string format: date-time completedAt: oneOf: - type: 'null' - type: string format: date-time additionalProperties: false required: - id - organizationId - repositoryId - snapshotId - status - completeness - idempotencyKey - detectorRegistryHash - manifestHash - graphVersionId - fileCount - factCount - relationCount - warnings - startedAt - completedAt existing: type: boolean enum: - true inventory: type: 'null' additionalProperties: false required: - scanRun - existing - type: object properties: scanRun: type: object properties: status: type: string id: type: string organizationId: $ref: '#/components/schemas/OrganizationId' repositoryId: type: number manifestHash: type: string startedAt: type: string format: date-time completedAt: oneOf: - type: 'null' - type: string format: date-time idempotencyKey: type: string warnings: type: array items: type: string completeness: oneOf: - type: string enum: - failed - type: string enum: - complete - type: string enum: - partial graphVersionId: oneOf: - type: 'null' - type: string snapshotId: type: string detectorRegistryHash: type: string fileCount: type: number factCount: type: number relationCount: type: number additionalProperties: false required: - status - id - organizationId - repositoryId - manifestHash - startedAt - completedAt - idempotencyKey - warnings - completeness - graphVersionId - snapshotId - detectorRegistryHash - fileCount - factCount - relationCount existing: type: boolean enum: - false inventory: type: object properties: facts: type: array items: type: object properties: type: oneOf: - type: string enum: - policy - type: string enum: - owner - type: string enum: - prompt - type: string enum: - model_binding - type: string enum: - workflow - type: string enum: - dataset - type: string enum: - guardrail - type: string enum: - evaluator - type: string enum: - agent - type: string enum: - runtime - type: string enum: - baseline - type: string enum: - tool - type: string enum: - repository - type: string enum: - repository_snapshot - type: string enum: - workspace - type: string enum: - package - type: string enum: - source_file - type: string enum: - code_symbol - type: string enum: - ai_system - type: string enum: - business_objective_candidate - type: string enum: - business_objective - type: string enum: - requirement - type: string enum: - model_provider - type: string enum: - model_route - type: string enum: - mcp_server - type: string enum: - connector - type: string enum: - retrieval_pipeline - type: string enum: - corpus - type: string enum: - index - type: string enum: - embedding_model - type: string enum: - reranker - type: string enum: - memory_store - type: string enum: - memory_policy - type: string enum: - permission_boundary - type: string enum: - eval_suite - type: string enum: - test_case - type: string enum: - ci_workflow - type: string enum: - release_artifact - type: string enum: - deployment_target - type: string enum: - trace_stream - type: string enum: - production_monitor - type: string enum: - risk - type: string enum: - coverage_gap - type: string enum: - pull_request - type: string enum: - change_set stableKey: type: string label: type: string description: type: string confidence: type: number method: oneOf: - type: string enum: - workflow - type: string enum: - manifest - type: string enum: - dependency - type: string enum: - syntax - type: string enum: - static_flow - type: string enum: - configuration - type: string enum: - convention - type: string enum: - runtime_link - type: string enum: - model_inference - type: string enum: - human_confirmation sourceLocators: type: array items: type: object properties: path: type: string repositoryId: type: number commitSha: type: string blobSha: type: string contentHash: type: string startLine: type: number endLine: type: number language: type: string startColumn: type: number endColumn: type: number symbolKey: type: string protectedExcerptHash: type: string additionalProperties: false required: - path - repositoryId - commitSha - blobSha properties: type: object additionalProperties: oneOf: - type: 'null' - type: string - type: number - type: boolean enum: - false - type: boolean enum: - true - type: array items: type: string - type: array items: type: number additionalProperties: false required: - type - stableKey - label - confidence - method relations: type: array items: type: object properties: sourceKey: type: string targetKey: type: string relation: oneOf: - type: string enum: - contains - type: string enum: - verified_by - type: string enum: - defines - type: string enum: - imports - type: string enum: - calls - type: string enum: - invokes - type: string enum: - routes_to - type: string enum: - uses_model - type: string enum: - uses_prompt - type: string enum: - exposes_tool - type: string enum: - connects_to - type: string enum: - retrieves_from - type: string enum: - indexes - type: string enum: - embeds_with - type: string enum: - reranks_with - type: string enum: - reads_memory - type: string enum: - writes_memory - type: string enum: - guarded_by - type: string enum: - authorized_by - type: string enum: - evaluated_by - type: string enum: - covered_by - type: string enum: - gated_by - type: string enum: - monitored_by - type: string enum: - deploys_to - type: string enum: - owned_by - type: string enum: - affects - type: string enum: - satisfies - type: string enum: - lacks_coverage_for - type: string enum: - derived_from - type: string enum: - changed_by - type: string enum: - failed_in - type: string enum: - repaired_by - type: string enum: - published_as - type: string enum: - supersedes confidence: type: number additionalProperties: false required: - sourceKey - targetKey - relation - confidence packRecommendations: type: array items: type: object properties: packId: type: string packVersion: type: string domain: oneOf: - type: string enum: - healthcare - type: string enum: - legal - type: string enum: - support - type: string enum: - coding - type: string enum: - financial confidence: type: number priority: oneOf: - type: string enum: - required - type: string enum: - recommended - type: string enum: - consider reasonCodes: type: array items: type: string explanation: type: string evidence: type: array items: type: object properties: stableKey: type: string label: type: string confidence: type: number sourceLocators: type: array items: type: object properties: path: type: string repositoryId: type: number commitSha: type: string blobSha: type: string contentHash: type: string startLine: type: number endLine: type: number language: type: string startColumn: type: number endColumn: type: number symbolKey: type: string protectedExcerptHash: type: string additionalProperties: false required: - path - repositoryId - commitSha - blobSha additionalProperties: false required: - stableKey - label - confidence - sourceLocators coverageState: oneOf: - type: string enum: - installed - type: string enum: - uncovered additionalProperties: false required: - packId - packVersion - domain - confidence - priority - reasonCodes - explanation - evidence - coverageState tree: type: object properties: entryCount: type: number contentCandidateCount: type: number analyzedFileCount: type: number truncated: type: boolean additionalProperties: false required: - entryCount - contentCandidateCount - analyzedFileCount - truncated additionalProperties: false required: - facts - relations - packRecommendations - tree additionalProperties: false required: - scanRun - existing - inventory OrganizationId: type: string format: uuid ApiError: type: object properties: error: type: object properties: code: type: string enum: - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - VALIDATION_ERROR - RATE_LIMITED - CONFLICT - INTERNAL_ERROR - SERVICE_UNAVAILABLE - QUOTA_EXCEEDED - NO_ORG_MEMBERSHIP - CROSS_ORG_REFERENCE - INCOMPLETE - MALFORMED message: type: string details: {} requestId: type: string format: uuid required: - code - message required: - error responses: ValidationError: description: Validation error content: application/json: schema: $ref: '#/components/schemas/ApiError' Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ApiError' Forbidden: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiError' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ApiError' Conflict: description: Conflict content: application/json: schema: $ref: '#/components/schemas/ApiError' RateLimited: description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key or Session Token ````