> ## Documentation Index > Fetch the complete documentation index at: https://lightsage.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Delete Eval > Permanently deletes an eval and all of its saved configurations. ## OpenAPI ````yaml /openapi.json delete /v2/evals/{eval_id} openapi: 3.1.0 info: title: Lightsage Public API description: Public API for Lightsage CLI and external integrations. version: 1.0.0 servers: - url: https://api.lightsage.com description: Production security: [] tags: - name: Status description: Check API availability and validate the calling API key. - name: Visibility description: >- Measure visibility, citations, competitors, and prompt performance across answer platforms. - name: Prompts description: Manage tracked prompts and topics, and inspect their stored runs. - name: Opportunities description: Review ranked opportunities computed from prompt visibility results. - name: Tasks description: Manage the persisted action queue and task lifecycle. - name: Site Audits description: Review website audit results and page-level findings. - name: Evals description: Define eval tasks, judges, subjects, and saved configurations. - name: Eval Templates description: >- Select reusable judges, targets, schedules, metadata, and runtime settings with `POST /v2/eval-templates`, then copy only those settings into prompt-specific evals with `POST /v2/evals/batch`. Templates never contain prompts and remain independent from evals created from them. - name: Eval Runs description: Start eval runs and inspect their lifecycle state. - name: Eval Results description: Review completed eval outcomes and diagnostic details. - name: Agent Preference description: >- Compare your company head-to-head with a tracked competitor. Create a comparison with `POST /v2/agent-preference/evals`, run it with `POST /v2/eval-runs`, then read which company agents recommended. - name: Agents description: List runnable coding-agent harness and model combinations. - name: Repositories description: Manage reusable Git repository workspaces. - name: Environments description: List reusable runtime environments without exposing secret values. - name: MCP Servers description: List reusable MCP server integrations without exposing credentials. - name: CLIs description: List reusable command-line interfaces without exposing setup commands. - name: Skills description: List reusable skills available to workflows and evals. paths: /v2/evals/{eval_id}: delete: tags: - Evals summary: Delete Eval description: Permanently deletes an eval and all of its saved configurations. operationId: v2_evals_delete parameters: - name: eval_id in: path required: true schema: type: string title: Eval Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/V2Eval' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - LightsageApiKeyAuth: [] components: schemas: V2Eval: properties: id: type: string title: Id name: type: string title: Name prompts: items: type: string type: array title: Prompts judges: items: type: string type: array title: Judges agent: items: type: string type: array title: Agent persona: anyOf: - type: string - type: 'null' title: Persona clis: items: anyOf: - $ref: '#/components/schemas/V2SavedCliReference' - $ref: '#/components/schemas/V2InlineCliReference' type: array title: Clis mcps: items: anyOf: - $ref: '#/components/schemas/V2SavedMcpReference' - $ref: '#/components/schemas/V2InlineMcpDefinition' type: array title: Mcps setup_commands: items: type: string type: array title: Setup Commands cleanup_commands: items: type: string type: array title: Cleanup Commands search_grounding: $ref: '#/components/schemas/SearchGroundingMode' description: 'Saved web-retrieval policy: disabled, enabled, or default.' default: default runs: type: integer maximum: 20 minimum: 1 title: Runs default: 1 tags: items: type: string type: array title: Tags created_at: anyOf: - type: string - type: 'null' title: Created At updated_at: anyOf: - type: string - type: 'null' title: Updated At type: object required: - id - name title: V2Eval HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError V2SavedCliReference: properties: id: type: string minLength: 1 title: Id description: Saved CLI ID from `GET /v2/clis`. additionalProperties: false type: object required: - id title: V2SavedCliReference V2InlineCliReference: properties: install_command: type: string maxLength: 4000 minLength: 1 title: Install Command description: Shell command to install this CLI before the agent starts. additionalProperties: false type: object required: - install_command title: V2InlineCliReference V2SavedMcpReference: properties: id: type: string minLength: 1 title: Id description: Saved MCP server ID from `GET /v2/mcp-servers`. additionalProperties: false type: object required: - id title: V2SavedMcpReference V2InlineMcpDefinition: properties: name: type: string maxLength: 100 minLength: 1 title: Name description: Stable server name used in the selected agent's MCP config. type: type: string enum: - http - sse - stdio title: Type url: anyOf: - type: string - type: 'null' title: Url description: HTTPS endpoint for an `http` or `sse` MCP server. headers: additionalProperties: type: string type: object maxProperties: 50 title: Headers description: >- HTTP headers. Reference run secrets with `${VARIABLE_NAME}` instead of embedding credentials. command: anyOf: - type: string - type: 'null' title: Command description: Executable command for a `stdio` MCP server. args: items: type: string type: array maxItems: 100 title: Args env: additionalProperties: type: string type: object maxProperties: 100 title: Env description: >- Environment mapping for a `stdio` MCP server. Values may reference run secrets with `${VARIABLE_NAME}`. additionalProperties: false type: object required: - name - type title: V2InlineMcpDefinition SearchGroundingMode: type: string enum: - disabled - enabled - default title: SearchGroundingMode description: Requested web-retrieval behavior for an eval run. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: LightsageApiKeyAuth: type: apiKey in: header name: X-Lightsage-Api-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.